$git clone https://github.com/anyproto/anytype-mcpThe Anytype MCP Server is a Model Context Protocol (MCP) server enabling AI assistants to seamlessly interact with Anytype's API through natural language.
| 1 | # Anytype MCP Server |
| 2 | |
| 3 | <a href="https://npmjs.org/package/@anyproto/anytype-mcp"><img src="https://img.shields.io/npm/v/@anyproto/anytype-mcp.svg" alt="NPM version" height="20" /></a> |
| 4 | <a href="https://cursor.com/en-US/install-mcp?name=anytype&config=eyJlbnYiOnsiT1BFTkFQSV9NQ1BfSEVBREVSUyI6IntcIkF1dGhvcml6YXRpb25cIjpcIkJlYXJlciA8WU9VUl9BUElfS0VZPlwiLCBcIkFueXR5cGUtVmVyc2lvblwiOlwiMjAyNS0xMS0wOFwifSJ9LCJjb21tYW5kIjoibnB4IC15IEBhbnlwcm90by9hbnl0eXBlLW1jcCJ9"><img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Add anytype MCP server to Cursor" height="20" /></a> |
| 5 | <a href="https://lmstudio.ai/install-mcp?name=anytype&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkBhbnlwcm90by9hbnl0eXBlLW1jcCJdLCJlbnYiOnsiT1BFTkFQSV9NQ1BfSEVBREVSUyI6IntcIkF1dGhvcml6YXRpb25cIjpcIkJlYXJlciA8WU9VUl9BUElfS0VZPlwiLCBcIkFueXR5cGUtVmVyc2lvblwiOlwiMjAyNS0xMS0wOFwifSJ9fQ%3D%3D"><img src="https://files.lmstudio.ai/deeplink/mcp-install-light.svg" alt="Add MCP Server anytype to LM Studio" height="20" /></a> |
| 6 | <a href="https://kiro.dev/launch/mcp/add?name=anytype&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40anyproto%2Fanytype-mcp%22%5D%2C%22env%22%3A%7B%22OPENAPI_MCP_HEADERS%22%3A%22%7B%5C%22Authorization%5C%22%3A%5C%22Bearer%20%3CYOUR_API_KEY%3E%5C%22%2C%20%5C%22Anytype-Version%5C%22%3A%5C%222025-11-08%5C%22%7D%22%7D%7D"><img src="https://kiro.dev/images/add-to-kiro.svg" alt="Add to Kiro" height="20" /></a> |
| 7 | |
| 8 | The Anytype MCP Server is a [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server enabling AI assistants to seamlessly interact with [Anytype's API](https://github.com/anyproto/anytype-api) through natural language. |
| 9 | |
| 10 | 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. |
| 11 | |
| 12 | ## Features |
| 13 | |
| 14 | - Global & Space Search |
| 15 | - Spaces & Members |
| 16 | - Objects & Lists |
| 17 | - Properties & Tags |
| 18 | - Types & Templates |
| 19 | |
| 20 | ## Quick Start |
| 21 | |
| 22 | ### 1. Get Your API Key |
| 23 | |
| 24 | 1. Open Anytype |
| 25 | 2. Go to App Settings |
| 26 | 3. Navigate to API Keys section |
| 27 | 4. Click on `Create new` button |
| 28 | |
| 29 | <details> |
| 30 | <summary>Alternative: Get API key via CLI</summary> |
| 31 | |
| 32 | You can also get your API key using the command line: |
| 33 | |
| 34 | ```bash |
| 35 | npx -y @anyproto/anytype-mcp get-key |
| 36 | ``` |
| 37 | |
| 38 | </details> |
| 39 | |
| 40 | ### 2. Configure Your MCP Client |
| 41 | |
| 42 | #### Claude Desktop, Cursor, Windsurf, Raycast, etc. |
| 43 | |
| 44 | Add the following configuration to your MCP client settings after replacing `<YOUR_API_KEY>` with your actual API key: |
| 45 | |
| 46 | ```json |
| 47 | { |
| 48 | "mcpServers": { |
| 49 | "anytype": { |
| 50 | "command": "npx", |
| 51 | "args": ["-y", "@anyproto/anytype-mcp"], |
| 52 | "env": { |
| 53 | "OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer <YOUR_API_KEY>\", \"Anytype-Version\":\"2025-11-08\"}" |
| 54 | } |
| 55 | } |
| 56 | } |
| 57 | } |
| 58 | ``` |
| 59 | |
| 60 | > **Tip:** After creating an API key in Anytype, you can copy that ready-to-use configuration snippet with your API key already filled in from the API Keys section. |
| 61 | |
| 62 | #### Claude Code (CLI) |
| 63 | |
| 64 | Run this command to add the Anytype MCP server after replacing `<YOUR_API_KEY>` with your actual API key: |
| 65 | |
| 66 | ```bash |
| 67 | 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 |
| 68 | ``` |
| 69 | |
| 70 | <details> |
| 71 | <summary>Alternative: Global Installation</summary> |
| 72 | |
| 73 | If you prefer to install the package globally: |
| 74 | |
| 75 | 1. Install the package: |
| 76 | |
| 77 | ```bash |
| 78 | npm install -g @anyproto/anytype-mcp |
| 79 | ``` |
| 80 | |
| 81 | 2. Update your MCP client configuration to use the global installation: |
| 82 | |
| 83 | ```json |
| 84 | { |
| 85 | "mcpServers": { |
| 86 | "anytype": { |
| 87 | "command": "anytype-mcp", |
| 88 | "env": { |
| 89 | "OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer <YOUR_API_KEY>\", \"Anytype-Version\":\"2025-11-08\"}" |
| 90 | } |
| 91 | } |
| 92 | } |
| 93 | } |
| 94 | ``` |
| 95 | |
| 96 | </details> |
| 97 | |
| 98 | ### Custom API Base URL |
| 99 | |
| 100 | By default, the server connects to `http://127.0.0.1:31009`. For `anytype-cli` (port `31012`) or other custom base URLs, set `ANYTYPE_API_BASE_URL`: |
| 101 | |
| 102 | <details> |
| 103 | <summary>Example Configuration</summary> |
| 104 | |
| 105 | **MCP Client (Claude D |