
Anytype MCP Server: Setup for Claude, Cursor and Other Apps
Lets Claude, Cursor and other assistants search and edit your Anytype spaces, objects, types and properties.
The Anytype MCP server lets an AI assistant work with your Anytype notes: search across spaces, create and update objects, collections, types and properties. It is made by the Anytype team and runs on your computer against the Anytype desktop app, which must be open. You sign in with an API key made in the app's settings. The tools are built from Anytype's API when the server starts, so the exact list depends on your app version.
Good for
- Anytype users who want to find and organise notes by asking
- People who keep tasks, projects and wikis in Anytype
- Privacy-minded users who want notes to stay on their own machine
- Developers who script their knowledge base
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install @anyproto/anytype MCP
Claude Code
- 1
Copy this prompt.
Add the @anyproto/anytype MCP server to Claude Code. Run this command: claude mcp add anytype -e OPENAPI_MCP_HEADERS='{"Authorization":"Bearer <YOUR_API_KEY>", "Anytype-Version":"2025-11-08"}' -s user -- npx -y @anyproto/anytype-mcp Ask me for OPENAPI_MCP_HEADERS and only put the values in that config, nowhere else. Then check that it loaded and tell me if I need to sign in or restart. - 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Anytype desktop app running, Node.js, Anytype API key.
Read-only mode: There is no read-only mode. Use an API key from a space you can afford to change.
Create the API key in the Anytype app under App Settings, then API Keys, then Create new. Anytype can copy a ready-made config with the key filled in. The app must be running on the same computer, because the server talks to it at 127.0.0.1:31009.
From the project README. Source.
Tools
Searches all your spaces
Runs a full-text search over object names and indexed content in every loaded space. Each result carries its space ID.
Try: “Search all my spaces for notes that mention the Q3 budget.”
Read ·
API-search-globalLists your spaces
Returns the spaces in your Anytype account so later calls can use their IDs.
Try: “Which spaces do I have in Anytype?”
Read ·
API-list-spacesShows one space
Returns the details of a single space by its ID.
Try: “Show me the details of my Work space.”
Read ·
API-get-spaceCreates a space
Creates a new space in your account.
Try: “Create a space called Reading List.”
Write ·
API-create-spaceEdits a space
Changes the settings of an existing space, such as its name.
Try: “Rename my Work space to Projects.”
Write ·
API-update-spaceLists objects in a space
Returns the objects in one space, a page at a time.
Try: “List the objects in my Project Ideas space.”
Read ·
API-list-objectsReads one object
Fetches a single object with its properties and content.
Try: “Open the object called Weekly plan and summarise it.”
Read ·
API-get-objectCreates an object
Adds a new object of a chosen type to a space, such as a note, task or page.
Try: “Create a task called Book flights in my Work space.”
Write ·
API-create-objectEdits an object
Applies a list of edit operations to one object in order. If an operation fails, the object stays unchanged. Apps that only serve the older v1 API expose API-update-object instead.
Try: “Add a section called Risks to the Launch plan object.”
Write ·
API-patch-objectDeletes an object
Deletes an object. In the v2 API only objects created by the same API key can be deleted.
Try: “Delete the draft note you just created.”
Delete ·
API-delete-objectLists object types
Returns the object types defined in a space, such as Page or Task.
Try: “What object types exist in my Work space?”
Read ·
API-list-typesDeletes a type
Deletes an object type from a space.
Try: “Delete the Meeting Note type from my Work space.”
Delete ·
API-delete-typeLists properties
Returns the property definitions of a space, such as due date or tags.
Try: “List the properties in my Project Ideas space.”
Read ·
API-list-propertiesDeletes a property
Deletes a property definition from a space.
Try: “Remove the Priority property from my Work space.”
Delete ·
API-delete-propertyCreates a collection
Creates a collection and can add existing objects to it. IDs that do not exist in the space are refused.
Try: “Create a collection called Tasks for this week and add these two tasks.”
Write ·
API-create-collectionSends a chat message
Posts a message to a chat in a space.
Try: “Post 'Standup moved to 10am' in the Team chat.”
Write ·
API-add-chat-messageDeletes a chat message
Deletes a message from a chat.
Try: “Delete my last message in the Team chat.”
Delete ·
API-delete-chat-messageUploads a file
Adds a file to a space, either as an upload or from a URL that the Anytype app fetches. It returns the file ID that file and image blocks refer to.
Try: “Upload this image URL into my Project Ideas space.”
Write ·
API-upload-fileDownloads a file
Streams a file from a space into a private temporary folder on your computer and returns its path.
Try: “Download the PDF attached to the Contract object.”
Write ·
API-download-fileShows what your key can reach
Describes the API key in use, including whether it is limited to some spaces. It never returns the key itself.
Try: “Which spaces can my Anytype API key access?”
Read ·
API-auth-whoami
Read from the source code
Permissions
high risk · 4 things to watch
High risk
It can change and delete notes in your Anytype spaces using a key stored in your assistant config. Try it on a test space first and keep a backup of notes you care about.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
It can delete objects, types and properties
The Anytype API behind the tools has delete operations for objects, types, properties and chat messages. In the v2 API an object can be deleted only if the same API key created it, but types, properties and chat messages have no such limit in the spec. Try a test space first and keep backups. github.com
The API key has full access to your spaces
The key is stored in plain text in your assistant app config. Anyone or anything that can read that file can use it, so remove the key from Anytype settings when you stop using it. github.com
The tool list changes with your app version
The server reads the API description from the running app at startup, so tools can differ between versions. Restart the server after updating Anytype. github.com
File upload can fetch a URL
The upload operation accepts a file or a URL that the Anytype app fetches. Downloads are saved to a private temporary folder on your computer. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Talks to | None beyond the Anytype app on your computer at 127.0.0.1:31009 by default |
|---|---|
| Sign-in and keys | The Anytype API key sits in the MCP config of your assistant app, inside the OPENAPI_MCP_HEADERS value. |
Questions
Is the Anytype MCP server official?
Yes. It is published by the anyproto organization, the company behind Anytype.
Does it need an API key?
Yes. Create one in the Anytype app under App Settings, then API Keys. You can also run the package's get-key command, which asks you to approve a 4-digit code in the app.
Does Anytype have to be running?
Yes. The server talks to the Anytype app on your computer at 127.0.0.1:31009 by default. Set ANYTYPE_API_BASE_URL to use another address, such as anytype-cli on port 31012.
Which AI apps does it work with?
Apps that run local MCP servers, such as Claude Desktop, Claude Code, Cursor and Windsurf. It does not work with hosted-only apps like ChatGPT or n8n cloud, because it needs your local Anytype app.
Does it send my notes to the cloud?
The server itself only talks to the Anytype app on your computer. What the assistant does with the results depends on the assistant you use.
Can I run it read-only?
No. The README documents no read-only option, and the API includes edit and delete operations.
Why are only some tools listed here?
The tools are generated from the Anytype API when the server starts, so the list depends on your app version. This page lists 20 of them, named API- plus the operation name, taken from the API definitions in the project's repository. Pairing and API-key operations are left out by the server.
Information
updated Nov 2, 2026
- Publisher
- Official
- Package
@anyproto/anytype-mcp- Registry
- npm
- Transport
- stdio
- Auth
- token in env
- Version
- 1.0.7
- License
- MIT
- Last commit
- Oct 26, 2026
- Listed in
- Official MCP registry
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 2Hide
- github.com · github.com
- github.com · github.com