MCP Server

DEVONthink MCP (istefox) MCP Server

Name: DEVONthink MCP (istefox) MCP Server
Author: io.github.istefox

io.github.istefox/dt-mcp

Repository Registry

What is the DEVONthink MCP (istefox) MCP server?

MCP server for DEVONthink 4 — outcome-oriented tools, preview-then-apply, audit + undo.

How to install DEVONthink MCP (istefox)

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

ISTEFOX_FAST_LIST_DATABASES
Set to '1' to skip recursive record_count when listing databases. Useful for databases with tens of thousands of records where the first call would otherwise take several seconds.
ISTEFOX_PREVIEW_TTL_S
Override TTL in seconds for preview_token returned by file_document/bulk_apply dry_run (default 300, range 1-3600).
ISTEFOX_RAG_ENABLED
Set to '1' to enable embedded ChromaDB vector retrieval for ask_database and search (mode=hybrid). EXPERIMENTAL in 0.1.0; embedding model not yet benchmarked cross-corpus (see ADR-008).
ISTEFOX_RAG_MODEL
sentence-transformers model name used by the RAG provider. Default paraphrase-multilingual-MiniLM-L12-v2 (~120MB). Override examples: BAAI/bge-m3 (~2.2GB).

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "dt-mcp": {
      "command": "https://github.com/istefox/istefox-dt-mcp/releases/download/v0.5.2/istefox-dt-mcp-0.5.2.mcpb",
      "args": [],
      "env": {
        "ISTEFOX_FAST_LIST_DATABASES": "<YOUR_ISTEFOX_FAST_LIST_DATABASES>",
        "ISTEFOX_PREVIEW_TTL_S": "<YOUR_ISTEFOX_PREVIEW_TTL_S>",
        "ISTEFOX_RAG_ENABLED": "<YOUR_ISTEFOX_RAG_ENABLED>",
        "ISTEFOX_RAG_MODEL": "<YOUR_ISTEFOX_RAG_MODEL>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "dt-mcp": {
      "command": "https://github.com/istefox/istefox-dt-mcp/releases/download/v0.5.2/istefox-dt-mcp-0.5.2.mcpb",
      "args": [],
      "env": {
        "ISTEFOX_FAST_LIST_DATABASES": "<YOUR_ISTEFOX_FAST_LIST_DATABASES>",
        "ISTEFOX_PREVIEW_TTL_S": "<YOUR_ISTEFOX_PREVIEW_TTL_S>",
        "ISTEFOX_RAG_ENABLED": "<YOUR_ISTEFOX_RAG_ENABLED>",
        "ISTEFOX_RAG_MODEL": "<YOUR_ISTEFOX_RAG_MODEL>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "dt-mcp": {
      "command": "https://github.com/istefox/istefox-dt-mcp/releases/download/v0.5.2/istefox-dt-mcp-0.5.2.mcpb",
      "args": [],
      "env": {
        "ISTEFOX_FAST_LIST_DATABASES": "<YOUR_ISTEFOX_FAST_LIST_DATABASES>",
        "ISTEFOX_PREVIEW_TTL_S": "<YOUR_ISTEFOX_PREVIEW_TTL_S>",
        "ISTEFOX_RAG_ENABLED": "<YOUR_ISTEFOX_RAG_ENABLED>",
        "ISTEFOX_RAG_MODEL": "<YOUR_ISTEFOX_RAG_MODEL>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "dt-mcp": {
      "type": "stdio",
      "command": "https://github.com/istefox/istefox-dt-mcp/releases/download/v0.5.2/istefox-dt-mcp-0.5.2.mcpb",
      "args": [],
      "env": {
        "ISTEFOX_FAST_LIST_DATABASES": "<YOUR_ISTEFOX_FAST_LIST_DATABASES>",
        "ISTEFOX_PREVIEW_TTL_S": "<YOUR_ISTEFOX_PREVIEW_TTL_S>",
        "ISTEFOX_RAG_ENABLED": "<YOUR_ISTEFOX_RAG_ENABLED>",
        "ISTEFOX_RAG_MODEL": "<YOUR_ISTEFOX_RAG_MODEL>"
      }
    }
  }
}

Claude Code

claude mcp add dt-mcp --env ISTEFOX_FAST_LIST_DATABASES=<YOUR_ISTEFOX_FAST_LIST_DATABASES> --env ISTEFOX_PREVIEW_TTL_S=<YOUR_ISTEFOX_PREVIEW_TTL_S> --env ISTEFOX_RAG_ENABLED=<YOUR_ISTEFOX_RAG_ENABLED> --env ISTEFOX_RAG_MODEL=<YOUR_ISTEFOX_RAG_MODEL> -- https://github.com/istefox/istefox-dt-mcp/releases/download/v0.5.2/istefox-dt-mcp-0.5.2.mcpb