Anytype MCP

The Anytype MCP server is a model context protocol service based on the Anytype API, allowing AI assistants and other MCP clients to interact with Anytype data, including functions such as querying, creating, and deleting spaces and objects.

Knowledge management and memory Developer tools #Knowledge Management #API Integration #Data Interaction Local .TypeScript

rating : 2.5 points

downloads : 238

update time : 2025-04-28

What is the Anytype MCP Server?

This is a middleware service based on the Model Context Protocol (MCP), serving as a bridge between the Anytype desktop application and AI assistants. It standardizes the data access interface, enabling you to manage the knowledge base content through natural language instructions.

How to use the Anytype MCP Server?

After installation and configuration, the AI assistant can help you search for notes, organize documents, create knowledge cards, etc. For example, directly ask 'Find me the notes about the project plan from last week', and the system will automatically retrieve relevant content.

Use Cases

It is particularly suitable for scenarios where AI is frequently used to process personal knowledge bases, such as literature management during academic research, material retrieval during writing, and progress tracking in project management.

Main Features

Intelligent Data QuerySupports various query methods such as full-text search across spaces, object filtering by conditions, and retrieval of detailed content.

Content ManagementCreate/delete documents or spaces, export content in Markdown format, and manage list views.

Response OptimizationIntelligently filters out non-essential data fields, significantly reducing the token consumption for AI processing.

Advantages and Limitations

Advantages

Seamlessly integrates the Anytype knowledge base with AI workflows

Optimized response data saves AI processing resources

Supports full CRUD operations

Limitations

Requires the Anytype desktop application to be running

Some advanced features require technical configuration

The API version depends on a specific Anytype client version

How to Use

Installation Preparation

Ensure that Node.js 18+ and the Anytype desktop application are installed.

Get the Application Key

Obtain Anytype API access through the built-in tool.

Service Configuration

Add the generated App Key to the MCP client configuration.

Usage Examples

Literature ManagementLet the AI assistant automatically organize research literature into specified categories.

Meeting RecordsAutomatically generate structured meeting minutes after voice-to-text conversion.

Frequently Asked Questions

Why can't I connect to the Anytype service?

How to get more detailed object data?

Is mobile usage supported?

Related Resources

Anytype Official Documentation

Explanation of Anytype's core functions

MCP Protocol Specification

Technical standard for the Model Context Protocol

GitHub Repository

Project source code and issue tracking

🚀 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 Anytype API definition v0.46+ (2025-03-17). Please ensure your Anytype desktop version is compatible with this.

🚀 Quick Start

This is an MCP server that offers access to the Anytype API. It enables AI assistants and other MCP clients to interact with your Anytype data. Make sure your Anytype desktop version is compatible with the API definition v0.46+ (2025-03-17).

✨ Features

Get a list of spaces (get_spaces).
Search for/retrieve objects within a specified space (get_objects, search_space) or perform a global search (global_search).
Retrieve detailed content of an object (get_object_content, supporting full-text retrieval).
Create and delete spaces (create_space) and objects (create_object, delete_object).
Export an object to Markdown format (export_object).
Manage list views and objects in a list (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).

📦 Installation

Prerequisites

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

Manual Installation

Clone this repository:

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

Install dependencies:

npm install

Build the project (compile TypeScript to JavaScript in the build/ directory):

npm run build

Get an App Key: Before configuring the server, you need to obtain an App Key from Anytype. Refer to the "Get an App Key" section below.
Add the MCP server to your MCP configuration file.

Get an App Key

Run the npm run get-key script to get a new App Key, update it in your MCP configuration, and then restart your MCP client.

💻 Usage Examples

Anytype API Not Responding

Ensure that the Anytype desktop application is running. The MCP server connects to the local Anytype API at http://localhost:31009/v1.

Authentication Issues

If you encounter authentication errors:

Run npm run get-key to get a new App Key.
Update the new key in your MCP configuration file.
Restart your MCP client.

Local API Port

By default, the server connects to the Anytype API at http://localhost:31009/v1. If your Anytype installation uses a different port, you need to modify the apiBaseUrl variable in src/index.ts and rebuild the project (run npm run build). Configuring this property via environment variables is a potential future feature improvement.