Skip to main content

MCP integration

Connect Dewey to Claude, Cursor, and other MCP clients — hosted via OAuth or run locally over stdio.

Install hosted MCP#

Add the hosted MCP URL to Claude or Cursor and authenticate in-browser.

Hosted MCP is the easiest path — no local server, no API key in your client config. You add a URL to Claude Desktop, Cursor, or any MCP-compatible client and authorize the connection through a browser consent flow. The OAuth token is scoped per-org and revocable from the dashboard.

# Claude Desktop and Cursor both support custom MCP servers via URL.
# Add this URL in the client's MCP settings UI:
#
#   https://mcp.meetdewey.com/mcp
#
# The first request opens a consent screen at app.meetdewey.com.
# Approve, and the client receives a scoped OAuth token automatically.

See also

Install local MCP#

Run the MCP server locally with a DEWEY_API_KEY.

Local MCP is useful if you want to avoid the hosted OAuth flow or run against a self-hosted Dewey. The server is published as `@meetdewey/mcp` on npm and runs over stdio. Drop the snippet into your client config file and your API key authorizes every call.

# Claude Desktop config locations:
#   macOS:   ~/Library/Application Support/Claude/claude_desktop_config.json
#   Windows: %APPDATA%\Claude\claude_desktop_config.json
#
# Add the dewey entry to mcpServers:

Response

{
  "mcpServers": {
    "dewey": {
      "command": "npx",
      "args": ["-y", "@meetdewey/mcp"],
      "env": {
        "DEWEY_API_KEY": "dwy_live_..."
      }
    }
  }
}

See also

What the MCP server exposes#

The tools your agent gets when Dewey is connected.

Once Dewey is wired up, your MCP-compatible client gains a set of tools that map onto the REST API. Search and research are the most commonly invoked; the management tools come in handy when you want the agent to clean up its own corpus.

# Retrieval & research
dewey_list_collections        # enumerate available collections
dewey_search                  # hybrid keyword + semantic chunk search
dewey_scan_sections           # cheaper section-level scan
dewey_research                # agentic research with configurable depth
dewey_get_section             # full markdown of a single section
dewey_get_document_markdown   # full markdown of a document

# Document management
dewey_list_documents          # statuses, tags, metadata
dewey_get_document_sections   # table of contents
dewey_retry_document          # retry a failed doc
dewey_delete_document

# Claims & contradictions
dewey_list_claims             # filter by importance
dewey_list_contradictions
dewey_detect_contradictions
dewey_resolve_contradiction

# Duplicates
dewey_detect_duplicates
dewey_list_duplicate_groups
dewey_promote_duplicate_canonical
dewey_disband_duplicate_group

# Collection administration
dewey_get_collection_stats
dewey_update_collection
dewey_recompute_summaries
dewey_recompute_captions