Anytype MCP Server

Official

Official MCP server that lets AI assistants manage your encrypted Anytype wiki in natural language.

★ 524 Stars Category · Collaboration Very popular

64FMRS · C

Anytype MCP Server is the official Anytype-maintained MCP server, converting Anytype's OpenAPI specification into MCP tools so AI assistants can manage your encrypted, local and collaborative wiki in natural language. It runs over stdio via npm, is simple to configure, requires an API key and a local Anytype service, and suits existing Anytype users who want to bring AI into their workflow.

Reliability

10/20

Security and permissions

11/20

Maintenance

14/20

Documentation

14/20

Setup experience

15/20

Read the FMRS scoring method →

Anytype MCP Server is the official Model Context Protocol (MCP) server for Anytype. It converts Anytype's OpenAPI specification into MCP tools so AI assistants can interact with the Anytype API through natural language and manage your encrypted, local and collaborative wiki. Capabilities include global and space search, spaces and members, objects and lists, properties and tags, and types and templates. It runs over stdio and is distributed as the npm package @anyproto/anytype-mcp, requiring an OPENAPI_MCP_HEADERS environment variable containing Anytype API authentication headers. It connects to http://127.0.0.1:31009 by default, configurable via ANYTYPE_API_BASE_URL (for example port 31012 for anytype-cli).

Setup

Get your API key: open Anytype, go to App Settings, navigate to the API Keys section and click Create new. Alternatively run: npx -y @anyproto/anytype-mcp get-key. 2. Add the following to your MCP client (Claude Desktop, Cursor, Windsurf, Raycast, etc.), replacing <YOUR_API_KEY>: {"mcpServers":{"anytype":{"command":"npx","args":["-y","@anyproto/anytype-mcp"],"env":{"OPENAPI_MCP_HEADERS":"{\"Authorization\":\"Bearer <YOUR_API_KEY>\", \"Anytype-Version\":\"2025-11-08\"}"}}}}. 3. For Claude Code (CLI) run: 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. 4. For a custom API base URL (e.g. anytype-cli on port 31012), set ANYTYPE_API_BASE_URL. You can also install globally with npm install -g @anyproto/anytype-mcp and start it with the command anytype-mcp.

claude_desktop_config.json

{"mcpServers":{"anytype":{"command":"npx","args":["-y","@anyproto/anytype-mcp"],"env":{"OPENAPI_MCP_HEADERS":"{\"Authorization\":\"Bearer <YOUR_API_KEY>\", \"Anytype-Version\":\"2025-11-08\"}"}}}}

Generate and validate client config

Fit and risk

Best for

Users who already rely on Anytype as a personal or collaborative knowledge base
Users who want to create and manage Anytype objects quickly with natural language
Advanced users running the Anytype desktop app locally who want AI assistant integration

Not for

Users without Anytype installed or running and unable to obtain an API key
Scenarios needing a remotely hosted service instead of a local stdio process
Users who want zero configuration without setting environment variables

Required permissions

Requires an Anytype API key passed via an Authorization: Bearer header
Needs access to the local Anytype API service (default http://127.0.0.1:31009)
Passes authentication headers through the OPENAPI_MCP_HEADERS environment variable, treated as secret
Runs an npx command locally as a stdio subprocess

Risks and side effects

OPENAPI_MCP_HEADERS contains the API key; leaking this configuration can expose Anytype data
The server can create and modify spaces, objects and lists on behalf of the key owner
Running npx -y downloads and executes package code from npm
Pointing ANYTYPE_API_BASE_URL at an untrusted address can send authentication headers there

Troubleshooting

Ensure the Anytype app is running and its API service is reachable (default 127.0.0.1:31009)
Verify OPENAPI_MCP_HEADERS is valid JSON and the API key is correct
If using anytype-cli (port 31012) or another address, confirm ANYTYPE_API_BASE_URL is set
Check that the Anytype-Version header matches the target API version (example uses 2025-11-08)
Copy the ready-to-use configuration snippet from the API Keys section in Anytype to avoid manual errors

Use cases

Create a new space with a title and description, e.g. 'Project Ideas'

Add a new object such as a Task to a specific space

Set due dates on tasks and assign them to a member

Create a collection and add existing tasks to it

Manage objects, lists, properties, tags, types and templates conversationally

Supported clients

Claude DesktopFull support

CursorFull support

WindsurfFull support

RaycastFull support

Claude CodeFull support

LM StudioFull support

KiroFull support

Related MCP servers

Compare with other MCP servers