Anytype MCP

🚀 Anytype MCP Server

The Anytype MCP Server is a Model Context Protocol (MCP) server implementation, 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
• Spaces & Members
• Objects & Lists
• Properties & Tags
• Types & Templates

🚀 Quick Start

1. Get Your API Key

1. Open Anytype
2. Go to Settings
3. Navigate to API Keys
4. Create a new API key

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

2. Configure Your MCP Client

Add the following configuration to your MCP client settings:

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

npm install -g @anyproto/anytype-mcp

{
  "mcpServers": {
    "anytype": {
      "command": "anytype-mcp",
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer <YOUR_API_KEY>\", \"Anytype-Version\":\"2025-05-20\"}"
      }
    }
  }
}

💻 Usage Examples

Basic Usage

Here are some examples of how you can interact with your Anytype:

• "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"

📦 Installation from Source

1. Clone the repository:

git clone https://github.com/anyproto/anytype-mcp.git
cd anytype-mcp

2. Install dependencies:

npm install -D

3. Build the project:

npm run build

4. Link the package globally (optional):

npm link

🤝 Contribution

Thank you for your desire to develop Anytype together!

❤️ This project and everyone involved in it is governed by the Code of Conduct.

🧑‍💻 Check out our contributing guide to learn about asking questions, creating issues, or submitting pull requests.

🫢 For security findings, please email security@anytype.io and refer to our security guide for more information.

🤝 Follow us on Github and join the Contributors Community.

📄 License

Made by Any — a Swiss association 🇨🇭

Licensed under MIT.