OFFICIAL ANYTYPE MCP WAS RELEASED HERE

https://github.com/anyproto/anytype-mcp

Anytype MCP Server

An MCP (Model Context Protocol) server that provides access to the Anytype API, allowing AI assistants and other MCP clients to interact with your Anytype data.

Based on the Anytype API definition v0.46+ (2025-03-17). Ensure your Anytype Desktop version is compatible.

Features

• Get list of spaces (get_spaces)
• Search/Get objects within a space (get_objects, search_space) or globally (global_search)
• Get detailed object content (get_object_content, supports retrieving full text)
• Create and delete spaces (create_space) and objects (create_object, delete_object)
• Export objects as markdown (export_object)
• Manage list views and objects within lists (get_list_views, get_list_view_objects, add_objects_to_list, remove_object_from_list)
• Get space members (get_space_members)
• Get types and templates (get_types, get_type_details, get_templates, get_template_details)

Prerequisites

• Node.js 18 or higher
• Anytype desktop application running locally
• An Anytype account

Installation

Manual Installation

1. Clone this repository:

   git clone https://github.com/Qwinty/anytype-mcp.git
   cd anytype-mcp
   

2. Install dependencies:

   npm install
   

3. Build the project (compiles TypeScript to JavaScript in build/):

   npm run build
   

4. Obtain an App Key: Before configuring the server, you need an App Key from Anytype. See the “Getting an App Key” section below.

5. Add the MCP server to your MCP configuration file

Getting an App Key

Before using the MCP server, you need to obtain an app key from the Anytype desktop application:

1. Make sure Anytype desktop is running

2. Run the helper script:

   npm run get-key
   

3. Follow the instructions to authorize the application

4. Note the app key for configuration

Configuration

Add the Anytype MCP server to your MCP configuration file:

• For Claude: Edit claude_desktop_config.json
• For other MCP clients: Edit their respective configuration files

Example configuration:

{
  "mcpServers": {
    "anytype": {
      "command": "node",
      "args": ["{path/to/anytype-mcp}/build/index.js"],
      "env": {
        "ANYTYPE_APP_KEY": "YOUR_APP_KEY_HERE"
      },
      "disabled": false
    }
  }
}

Replace path/to/anytype-mcp with the actual path to your installation and YOUR_APP_KEY_HERE with the app key you obtained.

Usage

Starting the server

The MCP server is usually started automatically by the MCP client. However, you can also start it manually for testing:

npm start

Available Tools

See Tools.md for a detailed list of available tools and their usage examples.

System Prompt