This MCP server provides access to DEVONthink functionality via the Model Context Protocol (MCP). It enables listing, searching, creating, modifying, and managing records and databases in DEVONthink Pro on macOS.

• Exposes a comprehensive set of DEVONthink operations as MCP tools
• List, search, and look up records by various attributes
• Create, delete, move, and rename records and groups
• Retrieve and modify record content, properties, and tags
• Create records from URLs in multiple formats
• List open databases and group contents
• All tools are type-safe and validated with Zod schemas

1. is_running

   • Checks if DEVONthink is currently running
   • No input required
   • Returns: { "success": true | false }

2. create_record

   • Creates new records (notes, bookmarks, groups) with specified properties
   • Input: record type, name, parent group, and optional metadata

3. delete_record

   • Deletes records by ID, name, or path
   • Input: record identifier

4. move_record

   • Moves records between groups
   • Input: record ID and destination group

5. get_record_properties

   • Retrieves detailed metadata and properties for records
   • Input: record identifier

6. search

   • Performs text-based searches with various comparison options
   • Input: query string and search options

7. lookup_record

   • Looks up records by filename, path, URL, tags, comment, or content hash (exact matches only)
   • Input: lookup type and value

8. create_from_url

   • Creates records from web URLs in multiple formats
   • Input: URL and format options

9. get_open_databases

   • Lists all currently open databases
   • No input required

10. list_group_content

    • Lists the content of a specific group
    • Input: group identifier

11. get_record_content

    • Retrieves the content of a specific record
    • Input: record identifier

12. rename_record

    • Renames a specific record
    • Input: record ID and new name

13. add_tags

    • Adds tags to a specific record
    • Input: record ID and tags

14. remove_tags

    • Removes tags from a specific record
    • Input: record ID and tags

15. classify

    • Gets classification proposals for a record using DEVONthink's AI
    • Input: record UUID, optional database name, comparison type, and tags option
    • Returns: Array of classification proposals (groups or tags) with scores

16. compare

    • Compares records to find similarities (hybrid approach)
    • Input: primary record UUID, optional second record UUID, database name, and comparison type
    • Returns: Either similar records (single mode) or detailed comparison analysis (two-record mode)

17. replicate_record

    • Replicates records within the same database (creates linked references)
    • Input: record identifier and destination group UUID

18. duplicate_record

    • Duplicates records to any database (creates independent copies)
    • Input: record identifier and destination group UUID

19. convert_record

    • Converts records to different formats (plain text, rich text, markdown, HTML, PDF, etc.)
    • Input: record identifier and target format

20. update_record_content

    • Updates the content of existing records while preserving UUID and metadata
    • Input: record UUID and new content

21. update_custom_metadata

    • Updates custom metadata (custom columns) for records
    • Input: record UUID and custom metadata key-value pairs

22. update_record_properties

    • Updates standard record properties like URL, comment, rating, label, flag, and name
    • Input: record UUID and property values to update

23. get_custom_metadata

    • Retrieves custom metadata (custom columns) from records
    • Input: record UUID and optional array of specific keys to retrieve
    • Returns: Object containing all found custom metadata key-value pairs

{
  "query": "project plan",
  "comparison": "contains",
  "database": "Inbox"
}

Returns:

{
  "results": [
    { "id": "123", "name": "Project Plan", "path": "/Inbox/Project Plan.md" }
  ]
}

Add to your Claude configuration:

{
  "mcpServers": {
    "devonthink": {
      "command": "npx",
      "args": ["-y", "mcp-server-devonthink"]
    }
  }
}

• Uses JXA (JavaScript for Automation) to control DEVONthink via AppleScript APIs
• All tool inputs are validated with Zod schemas for safety and clarity
• Returns structured JSON for all tool outputs
• Implements robust error handling for all operations
• Includes comprehensive tests using Vitest

See CLAUDE.md for full documentation, tool development guidelines, and API reference.