Anytype MCP

What is Anytype MCP?

The Anytype MCP server provides access to the Anytype API, allowing AI assistants and other MCP clients to interact with your Anytype data. It is built for users who run the Anytype desktop application and want to search, create, and manage objects programmatically.

How to use Anytype MCP?

Install Node.js 18+, clone the repository, run npm install && npm run build, and obtain an App Key via npm run get-key. Configure your MCP client (e.g., Claude) with the command node {path}/build/index.js and the environment variable ANYTYPE_APP_KEY. The server is started automatically by the client or can be run manually with npm start.

Key features of Anytype MCP

• Get list of spaces and search objects globally or within a space.
• Create, delete, and export objects (including markdown export).
• Manage list views and add/remove objects from lists.
• Retrieve detailed object content with optional full text.
• Token‑efficient responses with filtering; optional full text or raw JSON.

Use cases of Anytype MCP

• An AI assistant searches your Anytype notes and retrieves relevant objects.
• Automate creation of new objects or spaces from an external workflow.
• Export a specific Anytype object as markdown for backup or sharing.
• Manage list views in a project management space (e.g., add/remove tasks).
• Look up space members and inspect types/templates for object creation.

FAQ from Anytype MCP

Does Anytype MCP require the Anytype desktop app to be running?

Yes. The MCP server connects to the local Anytype API at http://localhost:31009/v1, so the Anytype desktop application must be running on the same computer.

How do I fix authentication errors?

Run npm run get-key to obtain a new App Key, update your MCP configuration with the new key, and restart your MCP client.

Can I change the local API port?

Currently, the port is hard‑coded in src/index.ts. You must modify the apiBaseUrl variable there and rebuild (npm run build). Making it configurable via an environment variable is a potential future improvement.

What response formats does Anytype MCP support?

By default, the server returns a simplified object with metadata only. You can pass include_text: true to get the full formatted text in a full_text field, or full_response: true to receive the raw JSON from the Anytype API.

What runtime dependencies does Anytype MCP have?

Node.js 18 or higher and a locally running Anytype desktop application with a valid Anytype account. Communication uses stdio and the local Anytype REST API.