An MCP server that bridges AI assistants with Anytype, an encrypted local wiki, enabling natural language interaction for knowledge management. It converts Anytype's OpenAPI specification into MCP tools, allowing users to organize objects, lists, properties, and more through conversational commands, benefiting those who wish to leverage AI for enhanced productivity within their Anytype knowledge base.

How It Works

This project implements a Model Context Protocol (MCP) server that acts as an intermediary between AI assistants and the Anytype API. It parses Anytype's OpenAPI specification to generate MCP tools, which are then exposed to AI clients. This allows natural language queries and commands to be translated into API calls that manage Anytype data, such as creating and organizing objects, spaces, and lists, offering a novel way to interact with personal knowledge graphs.

Quick Start & Requirements

• Primary Install/Run: Use npx -y @anyproto/anytype-mcp or install globally via npm install -g @anyproto/anytype-mcp.
• Prerequisites:
  • Anytype application installed and running.
  • An Anytype API Key (obtainable via Anytype App Settings -> API Keys or npx -y @anyproto/anytype-mcp get-key).
  • An MCP-compatible AI client (e.g., Claude Desktop, Cursor, Windsurf, Raycast).
  • Node.js and npm.
• Configuration: MCP client settings require specific command, args, and env configurations, notably OPENAPI_MCP_HEADERS containing Authorization and Anytype-Version.
• Development: Clone the repository, run npm install -D, npm run build, and optionally npm link.
• Links: GitHub repository: https://github.com/anyproto/anytype-mcp.

Highlighted Details

• Enables AI-driven management of Anytype features including Global & Space Search, Spaces & Members, Objects & Lists, Properties & Tags, and Types & Templates.
• Supports complex natural language commands for creating and modifying Anytype content, such as adding tasks with specific properties and due dates to lists.
• Provides example interactions demonstrating the breadth of conversational control over the Anytype knowledge base.

Maintenance & Community

• Developed by "Any", a Swiss association.
• Community engagement is encouraged via their GitHub presence and Contributors Community.
• A contributing guide is available for development and issue reporting.
• Security findings should be reported to security@anytype.io.

Licensing & Compatibility

• License: MIT License.
• Compatibility: The permissive MIT license generally allows for commercial use and integration into closed-source projects without significant restrictions.

Limitations & Caveats

The provided documentation does not explicitly detail known limitations, unsupported platforms, or alpha/beta status. Functionality is contingent on the Anytype application being operational and correctly configured MCP clients. The Anytype-Version header is fixed to "2025-11-08", indicating potential version-specific API compatibility.