Skip to main content

Anytype MCP Server

Overview​

The Anytype MCP Server is a Model Context Protocol (MCP) server enabling AI assistants to seamlessly interact with Anytype's API through natural language.

It bridges the gap between AI and Anytype's powerful features by converting Anytype's OpenAPI specification into MCP tools, allowing you to manage your knowledge base through conversation.

Features​

  • Global & Space Search - Find objects across your entire Anytype workspace
  • Spaces & Members - Manage spaces and collaborate with team members
  • Objects & Lists - Create, update, and organize your knowledge objects
  • Properties & Tags - Add metadata and categorize your content
  • Types & Templates - Work with custom object types and templates

Quick Start​

One-Click Installation​

For quick setup, you can use these one-click installation links:

note

You'll need to create an API key in Anytype and replace <YOUR_API_KEY> in the configuration with your actual key to get started.

Manual Setup​

1. Get Your API Key​

  1. Open Anytype
  2. Go to App Settings
  3. Navigate to API Keys section
  4. Click on Create new button
Alternative: Get API key via CLI

You can also get your API key using the command line:

npx -y @anyproto/anytype-mcp get-key

2. Configure Your MCP Client​

Claude Desktop, Cursor, Windsurf, Raycast, etc.​

Add the following configuration to your MCP client settings after replacing <YOUR_API_KEY> with your actual API key:

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

After creating an API key in Anytype, you can copy a ready-to-use configuration snippet with your API key already filled in from the API Keys section.

Claude Code (CLI)​

Run this command to add the Anytype MCP server after replacing <YOUR_API_KEY> with your actual API key:

claude mcp add anytype -e OPENAPI_MCP_HEADERS='{"Authorization":"Bearer <YOUR_API_KEY>", "Anytype-Version":"2025-05-20"}' -s user -- npx -y @anyproto/anytype-mcp
Alternative: Global Installation

If you prefer to install the package globally:

  1. Install the package:
npm install -g @anyproto/anytype-mcp
  1. Update your MCP client configuration to use the global installation:
{
  "mcpServers": {
    "anytype": {
      "command": "anytype-mcp",
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer <YOUR_API_KEY>\", \"Anytype-Version\":\"2025-05-20\"}"
      }
    }
  }
}

Example Interactions​

Here are some examples of how you can interact with your Anytype through the MCP server:

  • "Create a new space called 'Project Ideas' with description 'A space for storing project ideas'"
  • "Add a new object of type 'Task' with title 'Research AI trends' to the 'Project Ideas' space"
  • "Create a second one with title 'Dive deep into LLMs' with due date in 3 days and assign it to me"
  • "Now create a collection with the title 'Tasks for this week' and add the two tasks to that list. Set due date of the first one to 10 days from now"

Resources​