Anytype

v1.0.7Knowledge & Memorystable

Enables interaction with Anytype objects through the Anytype API, including creating, reading, updating, and deleting objects with full Markdown support. Features complete object update functionality that is not available in the official Anytype MCP

anytypeapimcpmcp-servermodelcontextprotocol
Share:
424
Stars
0
Downloads
0
Weekly
0/5

What is Anytype?

Anytype is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables interaction with anytype objects through the anytype api, including creating, reading, updating, and deleting objects with full markdown support. features complete object update functionality ...

Enables interaction with Anytype objects through the Anytype API, including creating, reading, updating, and deleting objects with full Markdown support. Features complete object update functionality that is not available in the official Anytype MCP

This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Enables interaction with Anytype objects through the Anytype

Use Cases

Create, read, update, and delete Anytype objects with full Markdown support.
Organize encrypted local knowledge in your collaborative wiki.
anyproto

Maintainer

LicenseMIT
Languagetypescript
Versionv1.0.7
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y @anyproto/anytype-mcp

Manual Installation

npx -y @anyproto/anytype-mcp

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Anytype

The Anytype MCP Server (published as @anyproto/anytype-mcp) enables AI assistants to read and write directly to Anytype — an encrypted, local-first, privacy-respecting personal wiki and knowledge management app. It exposes a full CRUD interface for objects, spaces, lists, properties, types, and templates, including complete object update functionality that the official Anytype MCP implementation does not provide. Knowledge workers and developers use it to let Claude or other AI models organize notes, create tasks, search across spaces, and manage structured data inside their private Anytype vaults through natural language.

Prerequisites

  • Anytype desktop application installed and running locally (it exposes a local API on port 31009 by default)
  • An Anytype API key, obtainable from Anytype App Settings → API or via 'npx -y @anyproto/anytype-mcp get-key'
  • Node.js 18 or later
  • An MCP-compatible client such as Claude Desktop or Claude Code
1

Obtain your Anytype API key

Run the get-key helper or open Anytype's App Settings and navigate to the API section. The key authorises the MCP server to access your local Anytype data.

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

Add the server to Claude Code

Use the claude mcp add command to register the server for your user. The OPENAPI_MCP_HEADERS environment variable carries both the bearer token and the required API version header.

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
3

Configure Claude Desktop

Add the server to your claude_desktop_config.json. The OPENAPI_MCP_HEADERS value must be valid JSON containing both the Authorization header and the Anytype-Version header.

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

Verify the connection

Ask your AI client to list your Anytype spaces. If the connection succeeds, you will see the names of your workspaces. If Anytype is not running, start the desktop app first — the MCP server connects to its local API at http://127.0.0.1:31009.

5

Explore tools across five capability areas

The server exposes tools in five groups: Global & Space Search, Spaces & Members, Objects & Lists, Properties & Tags, and Types & Templates. Use them to create objects, assign properties, build collections, and query your knowledge base.

Anytype Examples

Client configuration

Claude Desktop configuration block for the official Anytype MCP server with API key and version header.

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

Prompts to try

Natural language prompts for managing knowledge and tasks inside Anytype.

- "List all my Anytype spaces"
- "Create a new Task object in my Work space titled 'Review Q3 report' with a due date of next Friday"
- "Search my Anytype knowledge base for everything related to machine learning"
- "Create a new collection called 'Reading List 2026' and add three book objects to it"
- "Update the status property of the 'Website redesign' project object to In Progress"

Troubleshooting Anytype

Connection refused — cannot connect to Anytype API

The MCP server connects to Anytype's local API at http://127.0.0.1:31009. Make sure the Anytype desktop application is open and running before starting the MCP server. If you use anytype-cli instead, set ANYTYPE_API_BASE_URL to http://localhost:31012.

401 Unauthorized when calling tools

Verify that OPENAPI_MCP_HEADERS contains a valid JSON string with both the 'Authorization' and 'Anytype-Version' fields. In claude_desktop_config.json, inner quotes in the JSON string must be escaped with backslashes. Re-run 'npx -y @anyproto/anytype-mcp get-key' to obtain a fresh token.

Object updates fail silently or return a validation error

The Anytype-Version header must match a supported API version (use '2025-11-08' as shown). Type and property names are case-sensitive and must match the exact names defined in your Anytype workspace. Check the object's type and available properties before attempting an update.

Frequently Asked Questions about Anytype

What is Anytype?

Anytype is a Model Context Protocol (MCP) server that enables interaction with anytype objects through the anytype api, including creating, reading, updating, and deleting objects with full markdown support. features complete object update functionality that is not available in the official anytype mcp It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Anytype?

Install via npm with the command: npx -y @anyproto/anytype-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with Anytype?

Anytype works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Anytype free to use?

Yes, Anytype is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Knowledge & Memory MCP Servers

Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "anytype-mcp-server": { "command": "npx", "args": ["-y", "@anyproto/anytype-mcp"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Anytype?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides