PlugWiki
@anyproto/anytype-mcp logo

Anytype MCP Server: Setup for Claude, Cursor and Other Apps

OfficialLocal
Getnpm@anyproto/anytype-mcpanyproto/anytype-mcp

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.

Install @anyproto/anytype MCP

Claude Code

  1. 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. 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-global

  • Lists 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-spaces

  • Shows one space

    Returns the details of a single space by its ID.

    Try: “Show me the details of my Work space.”

    Read · API-get-space

  • Creates a space

    Creates a new space in your account.

    Try: “Create a space called Reading List.”

    Write · API-create-space

  • Edits a space

    Changes the settings of an existing space, such as its name.

    Try: “Rename my Work space to Projects.”

    Write · API-update-space

  • Lists 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-objects

  • Reads one object

    Fetches a single object with its properties and content.

    Try: “Open the object called Weekly plan and summarise it.”

    Read · API-get-object

  • Creates 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-object

  • Edits 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-object

  • Deletes 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-object

  • Lists 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-types

  • Deletes a type

    Deletes an object type from a space.

    Try: “Delete the Meeting Note type from my Work space.”

    Delete · API-delete-type

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 toNone beyond the Anytype app on your computer at 127.0.0.1:31009 by default
Sign-in and keysThe 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

GitHubnpmOfficial MCP RegistryChangelogIssues

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 2
  1. github.com · github.com
  2. github.com · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.