home / mcp / anytype mcp server

Anytype MCP Server

Provides MCP access to Anytype features, enabling AI assistants to query and manage knowledge through natural language.

Installation

Add the following to your MCP client configuration file.

Configuration

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

You can connect AI assistants to Anytype through the MCP server to perform knowledge management tasks using natural language. This server converts Anytype’s capabilities into MCP tools, enabling seamless querying and manipulation of spaces, objects, properties, and templates from conversations.

How to use

You interact with the Anytype MCP Server through your MCP client as if you were chatting with an assistant that knows how to work with Anytype. Ask it to search globally or within a specific space, create or update objects and lists, manage spaces and members, and work with properties, tags, types, and templates. Common workflows include creating spaces, adding objects to spaces, organizing items into lists, and setting due dates or assignments for tasks.

How to install

Prerequisites you’ll need before installing include: Node.js and npm (or another Node runtime and package manager you prefer). Follow the steps below to install the MCP server either as a global package or from source.

Install via npm globally

npm install -g @anyproto/anytype-mcp

Configure your MCP client to use the server

Add the MCP configuration for your client. Replace <YOUR_API_KEY> with your actual API key obtained from Anytype. The example below shows the standard configuration using npx to run the MCP server.

HTTP/stdio configuration example

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

Alternative: add via Claude CLI

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

Global installation and using the global binary

npm install -g @anyproto/anytype-mcp
```

```json
{
  "mcpServers": {
    "anytype": {
      "command": "anytype-mcp",
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer <YOUR_API_KEY>\", \"Anytype-Version\":\"2025-11-08\"}"
      }
    }
  }
}

Example interactions

These are practical examples of what you can tell the MCP server to do. You can create spaces, add objects, and build collections with tasks and due dates.

Development

If you want to run the server from source, follow these steps to clone, install dependencies, build, and optionally link the package for local development.

Installation from source

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

```bash
npm install -D
```

```bash
npm run build
```

```bash
npm link
```

Contribution

If you want to contribute, follow the community guidelines for questions, issues, and pull requests. For security findings, email the security contact and review the security guide.

Notes

This MCP server enables AI assistants to directly interface with Anytype data through natural language, supporting a range of capabilities from global searches to object and template management.

Available tools

global_search

Query across all accessible data sources in Anytype to locate spaces, objects, members, and templates.

space_management

Manage spaces and their members, including creating, updating, and listing spaces.

object_management

Create, update, and retrieve objects and lists within spaces, including setting titles and properties.

property_tag_management

Handle properties and tags on objects and lists, including filtering and sorting by properties.

types_templates

Create and manage types and templates to structure data in Anytype.