Skip to content
Back to search

anytype-mcp

An MCP server enabling AI assistants to interact with Anytype - your encrypted, local and collaborative wiki - to organize objects, lists, and more through natural language.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/anyproto/anytype-mcp with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/anyproto/anytype-mcp'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/anyproto--anytype-mcp/badge.svg)](/listings/anyproto--anytype-mcp)

HTML

<a href="/listings/anyproto--anytype-mcp"><img src="/api/listings/anyproto--anytype-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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

<details> <summary>Alternative: Get API key via CLI</summary>

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

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

</details>

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-11-08\"}"
      }
    }
  }
}

> **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.

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-11-08"}' -s user -- npx -y @anyproto/anytype-mcp

<details> <summary>Alternative: Global Installation</summary>

If you prefer to install the package globally:

1. Install the package:

npm install -g @anyproto/anytype-mcp

2. 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-11-08\"}"
      }
    }
  }
}

</details>

Custom API Base URL

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`:

<details> <summary>Example Configuration</summary>

**MCP Client (Claude Desktop, Cursor, etc.):**

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

**Claude Code (CLI):**

claude mcp add anytype \
  -e ANYTYPE_API_BASE_URL='http://localhost:31012' \
  -e OPENAPI_MCP_HEADERS='{"Authorization":"Bearer <YOUR_API_KEY>", "Anytype-Version":"2025-11-08"}' \
  -s user -- npx -y @anyproto/anytype-mcp

</details>

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 193 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # Anytype MCP Server
  2. <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>
  3. <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>
  4. <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>
  5. <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>
  6. 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.
  7. 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.
  8. ## Features
  9. - Global & Space Search
  10. - Spaces & Members
  11. - Objects & Lists
  12. - Properties & Tags
  13. - Types & Templates
  14. ## Quick Start
  15. ### 1. Get Your API Key
  16. 1. Open Anytype
  17. 2. Go to App Settings
  18. 3. Navigate to API Keys section
  19. 4. Click on `Create new` button
  20. <details>
  21. <summary>Alternative: Get API key via CLI</summary>
  22. You can also get your API key using the command line:
  23. ```bash
  24. npx -y @anyproto/anytype-mcp get-key
  25. ```
  26. </details>
  27. ### 2. Configure Your MCP Client
  28. #### Claude Desktop, Cursor, Windsurf, Raycast, etc.
  29. Add the following configuration to your MCP client settings after replacing `<YOUR_API_KEY>` with your actual API key:
  30. ```json
  31. {
  32. "mcpServers": {
  33. "anytype": {
  34. "command": "npx",
  35. "args": ["-y", "@anyproto/anytype-mcp"],
  36. "env": {
  37. "OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer <YOUR_API_KEY>\", \"Anytype-Version\":\"2025-11-08\"}"
  38. }
  39. }
  40. }
  41. }
  42. ```
  43. > **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.
  44. #### Claude Code (CLI)
  45. Run this command to add the Anytype MCP server after replacing `<YOUR_API_KEY>` with your actual API key:
  46. ```bash
  47. 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
  48. ```
  49. <details>
  50. <summary>Alternative: Global Installation</summary>
  51. If you prefer to install the package globally:
  52. 1. Install the package:
  53. ```bash
  54. npm install -g @anyproto/anytype-mcp
  55. ```
  56. 2. Update your MCP client configuration to use the global installation:
  57. ```json
  58. {
  59. "mcpServers": {
  60. "anytype": {
  61. "command": "anytype-mcp",
  62. "env": {
  63. "OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer <YOUR_API_KEY>\", \"Anytype-Version\":\"2025-11-08\"}"
  64. }
  65. }
  66. }
  67. }
  68. ```
  69. </details>
  70. ### Custom API Base URL
  71. 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`:
  72. <details>
  73. <summary>Example Configuration</summary>
  74. **MCP Client (Claude Desktop, Cursor, etc.):**
  75. ```json
  76. {
  77. "mcpServers": {
  78. "anytype": {
  79. "command": "npx",
  80. "args": ["-y", "@anyproto/anytype-mcp"],
  81. "env": {
  82. "ANYTYPE_API_BASE_URL": "http://localhost:31012",
  83. "OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer <YOUR_API_KEY>\", \"Anytype-Version\":\"2025-11-08\"}"
  84. }
  85. }
  86. }
  87. }
  88. ```
  89. **Claude Code (CLI):**
  90. ```bash
  91. claude mcp add anytype \
  92. -e ANYTYPE_API_BASE_URL='http://localhost:31012' \
  93. -e OPENAPI_MCP_HEADERS='{"Authorization":"Bearer <YOUR_API_KEY>", "Anytype-Version":"2025-11-08"}' \
  94. -s user -- npx -y @anyproto/anytype-mcp
  95. ```
  96. </details>
  97. ## Example Interactions
  98. Here are some examples of how you can interact with your Anytype:
  99. - "Create a new space called 'Project Ideas' with description 'A space for storing project ideas'"
  100. - "Add a new object of type 'Task' with title 'Research AI trends' to the 'Project Ideas' space"
  101. - "Create a second one with title 'Dive deep into LLMs' with due date in 3 days and assign it to me"
  102. - "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"
  103. ## Tool behavior and API versions
  104. MCP uses API v2 by default. If the v2 spec returns `404` or `410`, it falls back to v1 on the same server. Restart the MCP server after upgrading Anytype so it can discover the new API version.
  105. `API-download-file` saves files on the machine or container running MCP and returns the local path.
  106. See [Tool behavior](docs/tool-behavior.md) for selecting a spec explicitly, retrying writes, and troubleshooting.
  107. ## Development
  108. ### Installation from Source
  109. 1. Clone the repository:
  110. ```bash
  111. git clone https://github.com/anyproto/anytype-mcp.git
  112. cd anytype-mcp
  113. ```
  114. 2. Install dependencies (requires [Bun](https://bun.com)):
  115. ```bash
  116. bun install
  117. ```
  118. 3. Build the project:
  119. ```bash
  120. bun run build
  121. ```
  122. 4. Link the package globally (optional):
  123. ```bash
  124. bun link
  125. ```
  126. ## Contribution
  127. Thank you for your desire to develop Anytype together!
  128. ❤️ This project and everyone involved in it is governed by the [Code of Conduct](https://github.com/anyproto/.github/blob/main/docs/CODE_OF_CONDUCT.md).
  129. 🧑‍💻 Check out our [contributing guide](https://github.com/anyproto/.github/blob/main/docs/CONTRIBUTING.md) to learn about asking questions, creating issues, or submitting pull requests.
  130. 🫢 For security findings, please email [security@anytype.io](mailto:security@anytype.io) and refer to our [security guide](https://github.com/anyproto/.github/blob/main/docs/SECURITY.md) for more information.
  131. 🤝 Follow us on [Github](https://github.com/anyproto) and join the [Contributors Community](https://github.com/orgs/anyproto/discussions).
  132. ---
  133. Made by Any — a Swiss association 🇨🇭
  134. Licensed under [MIT](./LICENSE.md).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.