Anytype

v1.2.7Knowledge & Memorystable

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.

anytypeapimcpmcp-servermodelcontextprotocol
Share:
422
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 mcp server enabling ai assistants to interact with anytype - your encrypted, local and collaborative wiki - to organize objects, lists, and more through natural language.

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.

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

Features

  • An MCP server enabling AI assistants to interact with Anytyp

Use Cases

Organize objects, lists, and knowledge in an encrypted local wiki.
Interact with Anytype through natural language commands.
anyproto

Maintainer

LicenseMIT
Languagetypescript
Versionv1.2.7
UpdatedMay 20, 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 (@anyproto/anytype-mcp) lets AI assistants interact with Anytype — an encrypted, local-first personal and collaborative wiki — through natural language, covering the full lifecycle of knowledge objects: creating, reading, updating, and deleting objects, lists, spaces, properties, types, and templates. Unlike the official Anytype MCP, this community-maintained server includes complete object update functionality and Markdown-formatted content support. Productivity enthusiasts, developers, and teams use it to delegate note creation, task management, and knowledge organisation to their AI assistant while keeping all data in their private, encrypted Anytype vault.

Prerequisites

  • Anytype desktop application installed and running locally (available at https://anytype.io/)
  • An Anytype API key, obtained from App Settings → API in the Anytype desktop app 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

Get your Anytype API key

Run the built-in key helper to obtain an API key from your running Anytype instance. Copy the key printed to the terminal — you will need it in the next step.

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

Add the server to Claude Desktop

Edit your claude_desktop_config.json to add the anytype server. The OPENAPI_MCP_HEADERS variable must be a valid JSON string containing both the Authorization bearer token 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\"}"
      }
    }
  }
}
3

Add the server to Claude Code (CLI)

For Claude Code, use the 'claude mcp add' command. The -s user flag makes it available across all projects, and -e sets the environment variable.

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
4

Ensure Anytype desktop is running

The MCP server connects to Anytype's local REST API at http://127.0.0.1:31009. The Anytype desktop application must be open before you use the server. If you are using anytype-cli instead, set the ANYTYPE_API_BASE_URL environment variable to http://localhost:31012.

5

Use the five tool groups

The server organises its capabilities into five groups: Global & Space Search (find anything across your vault), Spaces & Members (manage workspaces), Objects & Lists (full CRUD on notes, tasks, pages), Properties & Tags (manage metadata), and Types & Templates (manage object schemas). All operations support Markdown-formatted content.

Anytype Examples

Client configuration

Claude Desktop configuration for @anyproto/anytype-mcp with the required authorization and API version headers.

{
  "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 your Anytype knowledge base through an AI assistant.

- "List all spaces in my Anytype vault"
- "Create a new note in my Personal space titled 'Ideas for Q3' with the following content: [content]"
- "Find all objects in Anytype tagged with 'project'"
- "Update the 'Website redesign' task: set status to Done and add a completion note"
- "Create a new collection called 'Book list' and add three items: Thinking Fast and Slow, Deep Work, and The Pragmatic Programmer"

Troubleshooting Anytype

Server cannot connect — ECONNREFUSED on port 31009

The Anytype desktop application must be running before the MCP server can connect to its local API. Open Anytype, wait for it to fully load, then restart your MCP client to re-establish the connection.

API key is rejected with 401 Unauthorized

Re-run 'npx -y @anyproto/anytype-mcp get-key' while Anytype is open to obtain a fresh key. In claude_desktop_config.json, ensure the OPENAPI_MCP_HEADERS value is a properly escaped JSON string — inner double quotes must be prefixed with backslashes.

Object creation succeeds but content is not formatted as expected

The server supports Markdown-formatted content. Use standard Markdown syntax in your prompts (e.g. '**bold**', '## Heading', '- list item'). If formatting is stripped, verify you are on a version of @anyproto/anytype-mcp that includes the full update functionality, not the official Anytype MCP package.

Frequently Asked Questions about Anytype

What is Anytype?

Anytype is a Model Context Protocol (MCP) server that mcp server enabling ai assistants to interact with anytype - your encrypted, local and collaborative wiki - to organize objects, lists, and more through natural language. 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": { "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