Back to search
mcp-server-devonthink
MCP serverGitHub
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
Markdown
[](/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)
- # Devonthink MCP Server
- 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.
- 
- ## Features
- - 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
- ## Tools
- ### Core Tools
- 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)
- ### Example: Search Tool
- ```json
- {
- "query": "project plan",
- "comparison": "contains",
- "database": "Inbox"
- }
- ```
- Returns:
- ```json
- {
- "results": [
- { "id": "123", "name": "Project Plan", "path": "/Inbox/Project Plan.md" }
- ]
- }
- ```
- ## Usage with Claude
- Add to your Claude configuration:
- ```json
- {
- "mcpServers": {
- "devonthink": {
- "command": "npx",
- "args": ["-y", "mcp-server-devonthink"]
- }
- }
- }
- ```
- ## Implementation Details
- - 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](./CLAUDE.md) for full documentation, tool development guidelines, and API reference.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.