Devonthink MCP Server
An MCP server that drives DEVONthink records and databases on macOS: search, create, move, tag and AI-classify from chat.
- 104 ★ on the repository
- Last commit
- GPL-3.0
Extended access
Why this level
- The agent can read, move and delete records in a local document database.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/devonthink-mcp-serverDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The agent can read, move and delete records in a local document database.
This is third-party code. Review the repository files before installing.
What it does
Devonthink MCP Server connects an agent to DEVONthink Pro on macOS. The agent searches records by text, looks up exact matches by name, path, URL, tag, comment or content hash, reads content and properties, creates notes, bookmarks and groups, and renames, moves or deletes them. End-to-end operations include creating a record from a web address in several formats, adding and removing tags, listing open databases and group contents. The `classify` tool asks DEVONthink for group and tag proposals, and the `ai` folder holds calls for asking questions about documents and building summaries. Control runs through JXA and inputs are validated with Zod.
Who it is for. Mac users who keep a document archive in DEVONthink and want an agent to work through it.
Good fit when
- Notes on a topic need to be found across the whole database and their content opened.
- Pages from a list of URLs must be saved to DEVONthink in one format.
- An inbox has piled up and records need tags and groups from classifier proposals.
- Two records must be compared and similar ones found.
Not a fit when
- DEVONthink is not installed or the machine is not running macOS.
- Only file search without the application is needed.
- The agent must not be allowed to delete or move records.
Example request
Find records tagged "contract" in the database, show their paths and propose a group for each without moving anything.MCP
- Transport
- stdio
- Authentication
- not required
Limitations
The server works only with a running DEVONthink Pro on macOS and reaches it through AppleScript, so the first launch triggers an automation permission prompt. The tools include delete, move and rename: with broad rights an agent can damage the database structure, so back up before bulk operations. The GPL-3.0 license sets its own terms for derivative works. The AI tools need DEVONthink's own AI features configured.
How to disable. Remove the `devonthink` entry from the MCP client configuration and, if you like, revoke the client's automation permission in macOS settings.
FAQ
Which tools are there?
About two dozen: `search`, `lookup_record`, `create_record`, `move_record`, `rename_record`, `add_tags`, `classify`, `compare`, `create_from_url` and more. The full list is in the README.
How do I connect it to Claude?
Add an `mcpServers` block with `command` set to `npx` and `args` set to `["-y", "mcp-server-devonthink"]`.
Must DEVONthink be running?
Yes. The `is_running` tool checks it, and without the running app the other calls will not work.
How do I find an exact match?
Use `lookup_record`: it takes a filename, path, URL, tags, comment or content hash and matches exactly.
What does classify do?
It asks DEVONthink for group or tag proposals for a record by UUID, with a comparison type and a tags option.
Discussion
No questions or reviews yet.
Related
MCP serversA local MCP server lets an agent search your Zotero library, Obsidian vault and Apple Notes through a C++ search core
A local document base for your agent: hybrid semantic and keyword search plus a web UI for browsing and uploads
The MCP server lets agents read and search local Molio vaults, browse file trees and ask questions about their contents.
The MCP server lets agents explore prepared documents, sections and related assets while retaining source references.
A technical wiki’s MCP lets agents read and edit documents while protected pages route changes through reviewable drafts.
A Zotero plugin with a built-in MCP server: the agent searches the library, reads PDFs and notes, and works with annotations and metadata
README in short
The server exposes DEVONthink operations over MCP, inputs are checked with Zod schemas and control runs through JXA.