Anytype MCP Server

What is Anytype MCP Server?

The Anytype MCP Server is a Model Context Protocol server that enables AI assistants to interact with Anytype's API through natural language. It converts Anytype’s OpenAPI specification into MCP tools, allowing users to manage their knowledge base conversationally.

How to use Anytype MCP Server?

First, obtain an API key from Anytype app settings or via the command npx -y @anyproto/anytype-mcp get-key. Then configure your MCP client by setting the OPENAPI_MCP_HEADERS environment variable with your key and the required Anytype-Version header. For custom API base URLs, set ANYTYPE_API_BASE_URL. Alternatively, install the package globally with npm install -g @anyproto/anytype-mcp.

Key features of Anytype MCP Server

• Global and space search across your Anytype knowledge base
• Manage spaces and their members
• Create, read, update, and delete objects and lists
• Work with properties and tags
• Define and use types and templates

Use cases of Anytype MCP Server

• Create a new space called “Project Ideas” with a description
• Add an object of a custom type (e.g., “Task”) with a title and other attributes
• Build a collection of objects and set due dates and assignments
• Search across all spaces or within a specific space
• Manage members and properties through conversation with an AI assistant

FAQ from Anytype MCP Server

How do I get an API key for Anytype MCP Server?

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 from your terminal.

Which MCP clients are supported?

Claude Desktop, Cursor, Windsurf, Raycast, Claude Code (CLI), and any MCP client that accepts a JSON configuration.

Can I use a custom API base URL?

Yes. Set the ANYTYPE_API_BASE_URL environment variable (default is http://127.0.0.1:31009). For example, http://localhost:31012 works with anytype-cli.

How do I install the server globally?

Run npm install -g @anyproto/anytype-mcp, then use anytype-mcp as the command in your MCP client configuration.

What environment variables are required for configuration?

You must provide OPENAPI_MCP_HEADERS with valid JSON containing Authorization (Bearer + your API key) and Anytype-Version (e.g., "2025-11-08"). ANYTYPE_API_BASE_URL is optional.