Skip to content
Back to search

mcp-server-devonthink

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…

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dvcrn--mcp-server-devonthink/badge.svg)](/listings/dvcrn--mcp-server-devonthink)

HTML

<a href="/listings/dvcrn--mcp-server-devonthink"><img src="/api/listings/dvcrn--mcp-server-devonthink/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 146 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Devonthink MCP Server
  2. 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.
  3. ![screenshot](./screenshot.png)
  4. ## Features
  5. - Exposes a comprehensive set of DEVONthink operations as MCP tools
  6. - List, search, and look up records by various attributes
  7. - Create, delete, move, and rename records and groups
  8. - Retrieve and modify record content, properties, and tags
  9. - Create records from URLs in multiple formats
  10. - List open databases and group contents
  11. - All tools are type-safe and validated with Zod schemas
  12. ## Tools
  13. ### Core Tools
  14. 1. `is_running`
  15. - Checks if DEVONthink is currently running
  16. - No input required
  17. - Returns: `{ "success": true | false }`
  18. 2. `create_record`
  19. - Creates new records (notes, bookmarks, groups) with specified properties
  20. - Input: record type, name, parent group, and optional metadata
  21. 3. `delete_record`
  22. - Deletes records by ID, name, or path
  23. - Input: record identifier
  24. 4. `move_record`
  25. - Moves records between groups
  26. - Input: record ID and destination group
  27. 5. `get_record_properties`
  28. - Retrieves detailed metadata and properties for records
  29. - Input: record identifier
  30. 6. `search`
  31. - Performs text-based searches with various comparison options
  32. - Input: query string and search options
  33. 7. `lookup_record`
  34. - Looks up records by filename, path, URL, tags, comment, or content hash (exact matches only)
  35. - Input: lookup type and value
  36. 8. `create_from_url`
  37. - Creates records from web URLs in multiple formats
  38. - Input: URL and format options
  39. 9. `get_open_databases`
  40. - Lists all currently open databases
  41. - No input required
  42. 10. `list_group_content`
  43. - Lists the content of a specific group
  44. - Input: group identifier
  45. 11. `get_record_content`
  46. - Retrieves the content of a specific record
  47. - Input: record identifier
  48. 12. `rename_record`
  49. - Renames a specific record
  50. - Input: record ID and new name
  51. 13. `add_tags`
  52. - Adds tags to a specific record
  53. - Input: record ID and tags
  54. 14. `remove_tags`
  55. - Removes tags from a specific record
  56. - Input: record ID and tags
  57. 15. `classify`
  58. - Gets classification proposals for a record using DEVONthink's AI
  59. - Input: record UUID, optional database name, comparison type, and tags option
  60. - Returns: Array of classification proposals (groups or tags) with scores
  61. 16. `compare`
  62. - Compares records to find similarities (hybrid approach)
  63. - Input: primary record UUID, optional second record UUID, database name, and comparison type
  64. - Returns: Either similar records (single mode) or detailed comparison analysis (two-record mode)
  65. ### Example: Search Tool
  66. ```json
  67. {
  68. "query": "project plan",
  69. "comparison": "contains",
  70. "database": "Inbox"
  71. }
  72. ```
  73. Returns:
  74. ```json
  75. {
  76. "results": [
  77. { "id": "123", "name": "Project Plan", "path": "/Inbox/Project Plan.md" }
  78. ]
  79. }
  80. ```
  81. ## Usage with Claude
  82. Add to your Claude configuration:
  83. ```json
  84. {
  85. "mcpServers": {
  86. "devonthink": {
  87. "command": "npx",
  88. "args": ["-y", "mcp-server-devonthink"]
  89. }
  90. }
  91. }
  92. ```
  93. ## Implementation Details
  94. - Uses JXA (JavaScript for Automation) to control DEVONthink via AppleScript APIs
  95. - All tool inputs are validated with Zod schemas for safety and clarity
  96. - Returns structured JSON for all tool outputs
  97. - Implements robust error handling for all operations
  98. - Includes comprehensive tests using Vitest
  99. See [CLAUDE.md](./CLAUDE.md) for full documentation, tool development guidelines, and API reference.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.