mcp -devonthink

This MCP server exposes DEVONthink functionality to the Model Context Protocol, allowing you to list, search, create, modify, and organize records and databases inside DEVONthink Pro on macOS. Core tools include is_running, create_record, delete_record, move_record, get_record_properties, search, lookup_record, create_from_url, get_open_databases, list_group_content, get_record_content, rename_record, add_tags, remove_tags, classify, and compare. Each tool is designed to provide a structured JSON interface, with input validation via Zod schemas to ensure safe and predictable operations. The server leverages JXA (JavaScript for Automation) to interact with DEVONthink through AppleScript APIs, returning consistent JSON outputs for scriptable automation and Claude integrations. To use, run the MCP server via the provided npx configuration and call the individual tools by name through the MCP interface, supplying the required inputs as described in the tool documentation.

Prerequisites:

• macOS with DEVONthink Pro installed
• Node.js and npm installed on your system

1. Ensure DEVONthink Pro is installed and accessible on your Mac.
2. Install the MCP server package (via npx as shown in the configuration):

# Prerequisite: has access to npx (comes with npm)
npx -y mcp-server-devonthink

3. Verify installation by starting the MCP server as configured (Claude or your MCP client can connect using the provided mcp_config).
4. (Optional) Install globally or locally as needed depending on your environment. If using npm scripts, you can pin to a specific version of the mcp-server-devonthink package for reproducibility.
5. Consult DEVONthink and macOS security/privacy prompts as the server will use JXA to automate DEVONthink; you may need to grant accessibility/automation permissions.

Note: This server relies on macOS-specific automation (JXA) and will not run on Linux or Windows environments without a compatible macOS automation layer.

Tips:

• The server uses JXA to control DEVONthink; ensure DEVONthink is installed and accessible, and that your user account has appropriate permissions.
• Inputs are validated with Zod schemas; if you see validation errors, adjust the input payload to match the expected fields (type, id, path, etc.).
• The Claude integration example demonstrates how to embed the server into a Claude configuration. You can replicate this structure in your own MCP client configuration.
• For operations affecting content or structure (rename, move, delete), consider performing a dry-run or using get_record_properties beforehand to verify targets.
• If you encounter authentication or accessibility prompts, grant the necessary permissions in macOS System Settings (Security & Privacy) under Automation and Accessibility.
• The package name referenced for npx is mcp-server-devonthink; if you pin a specific version, update the command accordingly.