Anytype

You run an MCP server that exposes the Anytype API to AI assistants and other MCP clients. It lets you list spaces, fetch objects, view content, create and delete items, export content as markdown, manage lists, and retrieve types and templates—so your assistants can interact with your Anytype data efficiently and securely.

How to use

Start by launching the MCP server alongside your Anytype Desktop app. The server talks to the local Anytype API, so you’ll configure your MCP client to connect to the local endpoint. Use the app key you obtain to authorize the MCP server with Anytype.

How to install

Prerequisites you need before installing the MCP server:

• Node.js 18 or higher

• Anytype desktop application running locally

• An Anytype account

Step by step installation

# 1. Clone the MCP server repository
git clone https://github.com/Qwinty/anytype-mcp.git
cd anytype-mcp

# 2. Install dependencies
npm install

# 3. Build the project (transpiles TypeScript to JavaScript in build/)
npm run build

# 4. Obtain an App Key from Anytype (see Getting an App Key section)
# 5. Configure the MCP server in your MCP client configuration file

Configuration and starting the server

Configure your MCP client to load the Anytype MCP server. The following is an example configuration snippet showing how to reference the local server after you build it and obtain an app key.

{
  "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.

## Obtaining the App Key

Before you can run the MCP server, obtain an app key from the Anytype desktop application: open Anytype, run the helper to get the key, authorize the app, and note the key for configuration.

## Starting the server manually

You can start the server manually for testing. The runtime command to use is the one you configured in the MCP client. If you followed the example above, you would start the server with the command you configured in the client, typically by running the configured startup command in your environment.

## System prompts and usage notes

Use the MCP client to query spaces, objects, and content through the Anytype MCP server. The server handles token-efficient responses by default, with options to include full text or raw API responses when needed.

## Security and access control

Protect your app key and configuration. Do not expose the app key in public repositories or shared environments. Rotate keys if you suspect compromise and limit permissions to required actions only.

## Troubleshooting

If the Anytype API does not respond, ensure Anytype Desktop is running and accessible at the local API endpoint. If authentication errors occur, refresh the app key using the helper and update your MCP configuration, then restart the client. By default, the server connects to http://localhost:31009/v1. If your setup uses a different port, adjust the apiBaseUrl in your configuration and rebuild if necessary.

## Notes

The MCP server supports a range of operations such as listing spaces, retrieving object content (including full text when requested), and exporting objects as markdown. You can tailor responses to balance detail against token usage by using include\_text and full\_response options when supported by your MCP client.

## Available tools

### get\_spaces

Retrieve the list of spaces available in your Anytype account.

### get\_objects

Fetch objects within a specific space, including essential metadata.

### search\_space

Search for objects within a space using filters or keywords.

### global\_search

Perform a global search across all spaces and objects.

### get\_object\_content

Get detailed content for a specific object, with optional full text retrieval.

### create\_space

Create a new space in your Anytype account.

### create\_object

Create a new object within a space.

### delete\_object

Delete an object by its ID.

### export\_object

Export an object as markdown for easy sharing.

### get\_list\_views

Retrieve list view definitions for lists.

### add\_objects\_to\_list

Add objects to a list view.

### remove\_object\_from\_list

Remove an object from a list view.

### get\_space\_members

Fetch members of a space.

### get\_types

List available content types.

### get\_type\_details

Retrieve details for a specific type.

### get\_templates

List available templates.

### get\_template\_details

Retrieve details for a specific template.