@meetdewey/mcp
MCP server for Dewey — search and research your document collections from Claude, Cursor, and any MCP-compatible agent. See the full API reference for details.
Installation
Add to your claude_desktop_config.json (or equivalent MCP client config):
{
"mcpServers": {
"dewey": {
"command": "/bin/sh",
"args": ["-lc", "npx -y @meetdewey/mcp"],
"env": {
"DEWEY_API_KEY": "dwy_live_...",
"DEWEY_COLLECTION_ID": "..."
}
}
}
}
Note for Windows users: replace
"command": "/bin/sh"and"args": ["-lc", "npx -y @meetdewey/mcp"]with"command": "npx"and"args": ["-y", "@meetdewey/mcp"]— the login-shell wrapper is only needed on macOS/Linux to pick up Homebrew and nvm PATH entries that Claude Desktop doesn't inherit.
Environment variables
| Variable | Required | Description |
|---|---|---|
DEWEY_API_KEY | Yes | Your Dewey project API key |
DEWEY_COLLECTION_ID | No | Default collection ID. When set, tools that accept collection_id will fall back to this value. |
DEWEY_API_URL | No | Override the API base URL (default: https://api.meetdewey.com/v1) |
Available tools
Search & research
| Tool | Description |
|---|---|
dewey_list_collections | List all collections in the project, including description and research instructions when set |
dewey_search | Hybrid semantic + keyword search over chunk content |
dewey_scan_sections | Lightweight search over section titles and summaries |
dewey_research | Agentic research query with configurable depth — returns a grounded, cited answer |
dewey_get_section | Fetch the full Markdown content of a section by ID |
Document management
| Tool | Description |
|---|---|
dewey_list_documents | List documents in a collection with their processing status |
dewey_get_document_sections | List all sections in a document (table of contents with heading levels and IDs) |
dewey_get_document_markdown | Fetch the full converted Markdown content of a document |
dewey_retry_document | Retry a failed document — clears error state and re-queues processing |
dewey_delete_document | Permanently delete a document and all its derived data |
Claims & contradictions
| Tool | Description |
|---|---|
dewey_list_claims | List extracted factual claims from a collection or specific document, filterable by importance (1–5) |
dewey_list_contradictions | List detected contradictions — clusters of conflicting claims with explanations and suggested resolutions |
dewey_detect_contradictions | Trigger an async contradiction detection run across all claims in a collection |
dewey_get_contradiction_run | Get the status and stats of the latest contradiction detection run (use to poll after dewey_detect_contradictions) |
dewey_resolve_contradiction | Apply a resolution instruction to a contradiction or dismiss it |
Deduplication
| Tool | Description |
|---|---|
dewey_detect_duplicates | Trigger an async deduplication run — identifies near-duplicate documents by measuring shared content across chunks and marks one per cluster as canonical |
dewey_get_duplicate_run | Get the status and stats of the latest deduplication run (use to poll after dewey_detect_duplicates) |
dewey_list_duplicate_groups | List near-duplicate groups with canonical + members and coverage percentages |
dewey_promote_duplicate_canonical | Promote a different member to canonical; old canonical becomes near_duplicate |
dewey_disband_duplicate_group | Disband a group; former members rejoin retrieval as distinct documents |
Non-canonical documents are excluded from retrieval and contradiction detection. Requires enableDeduplication: true on the collection (set via dewey_update_collection or the Dewey dashboard).
Collection settings
| Tool | Description |
|---|---|
dewey_get_collection_stats | Get document count, storage, section/chunk/claim counts, and processing status breakdown |
dewey_update_collection | Update collection name, description, research instructions, visibility, and feature flags |
dewey_recompute_summaries | Re-run AI section summarization across all documents (e.g. after changing the LLM model) |
dewey_recompute_captions | Re-run AI captioning for all images and tables across all documents |
dewey_delete_collection | Permanently delete a collection and all its data |
Research instructions
Collections can have natural-language instructions that are automatically injected into the research system prompt — for example, noting units, preferred sources, or how to handle missing information. They can be set in the Dewey dashboard, via the API, or directly through dewey_update_collection. When dewey_resolve_contradiction is used to apply a resolution, the suggested instruction is also appended here automatically.
Tool usage pattern
A typical read-only research workflow:
dewey_list_collections— discover available collections and understand their purposedewey_scan_sections— quickly explore document structure to identify relevant sectionsdewey_get_section— load full content of a specific sectiondewey_search— retrieve the most relevant chunks for a focused questiondewey_research— run a full agentic research query for questions that need multi-step reasoning
For deeper analysis and curation:
dewey_get_collection_stats— assess how much content has been processeddewey_list_claims— surface the most important facts across documentsdewey_list_contradictions— identify where documents disagreedewey_resolve_contradiction— apply or dismiss each contradiction, updating collection instructions automatically
License
MIT