productivity

Anytype▌

by anyproto

Transform any OpenAPI specification into callable tools. Easily test an API, handle authentication, and generate schemas

Converts any OpenAPI 3.0/3.1 specification into callable tools by automatically generating schemas from REST API endpoints, handling authentication via environment variables, and supporting file uploads through multipart form-data while filtering out destructive operations.

github stars

★ 323

GitHub npm

Works with any OpenAPI 3.0/3.1 specAutomatic schema generationBuilt-in safety filtering

best for

/ AI assistants needing to interact with REST APIs
/ Developers working with OpenAPI specifications
/ Automating API calls through natural language

capabilities

/ Convert OpenAPI specs to callable tools
/ Generate schemas from REST API endpoints
/ Handle API authentication via environment variables
/ Upload files through multipart form-data
/ Filter out destructive operations

what it does

Converts OpenAPI 3.0/3.1 specifications into callable tools that your AI assistant can use to interact with REST APIs. Automatically handles authentication and schema generation.

about

Anytype is a community-built MCP server published by anyproto that provides AI assistants with tools and capabilities via the Model Context Protocol. Transform any OpenAPI specification into callable tools. Easily test an API, handle authentication, and generate schemas It is categorized under productivity.

how to install

You can install Anytype in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.

license

MIT

Anytype is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.

readme

Anytype MCP Server

The Anytype MCP Server is a Model Context Protocol (MCP) server enabling AI assistants to seamlessly interact with Anytype's API through natural language.

It bridges the gap between AI and Anytype's powerful features by converting Anytype's OpenAPI specification into MCP tools, allowing you to manage your knowledge base through conversation.

Features

Global & Space Search
Spaces & Members
Objects & Lists
Properties & Tags
Types & Templates

Quick Start

1. Get Your API Key

Open Anytype
Go to App Settings
Navigate to API Keys section
Click on Create new button

<details> <summary>Alternative: Get API key via CLI</summary>

You can also get your API key using the command line:

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

</details>

2. Configure Your MCP Client

Claude Desktop, Cursor, Windsurf, Raycast, etc.

Add the following configuration to your MCP client settings after replacing <YOUR_API_KEY> with your actual API key:

{
  "mcpServers": {
    "anytype": {
      "command": "npx",
      "args": ["-y", "@anyproto/anytype-mcp"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{"Authorization":"Bearer <YOUR_API_KEY>", "Anytype-Version":"2025-11-08"}"
      }
    }
  }
}

Tip: After creating an API key in Anytype, you can copy that ready-to-use configuration snippet with your API key already filled in from the API Keys section.

Claude Code (CLI)

Run this command to add the Anytype MCP server after replacing <YOUR_API_KEY> with your actual API key:

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

<details> <summary>Alternative: Global Installation</summary>

If you prefer to install the package globally:

Install the package:

npm install -g @anyproto/anytype-mcp

Update your MCP client configuration to use the global installation:

{
  "mcpServers": {
    "anytype": {
      "command": "anytype-mcp",
      "env": {
        "OPENAPI_MCP_HEADERS": "{"Authorization":"Bearer <YOUR_API_KEY>", "Anytype-Version":"2025-11-08"}"
      }
    }
  }
}

</details>

Custom API Base URL

By default, the server connects to http://127.0.0.1:31009. For anytype-cli (port 31012) or other custom base URLs, set ANYTYPE_API_BASE_URL:

<details> <summary>Example Configuration</summary>

MCP Client (Claude Desktop, Cursor, etc.):

{
  "mcpServers": {
    "anytype": {
      "command": "npx",
      "args": ["-y", "@anyproto/anytype-mcp"],
      "env": {
        "ANYTYPE_API_BASE_URL": "http://localhost:31012",
        "OPENAPI_MCP_HEADERS": "{"Authorization":"Bearer <YOUR_API_KEY>", "Anytype-Version":"2025-11-08"}"
      }
    }
  }
}

Claude Code (CLI):

claude mcp add anytype \
  -e ANYTYPE_API_BASE_URL='http://localhost:31012' \
  -e OPENAPI_MCP_HEADERS='{"Authorization":"Bearer <YOUR_API_KEY>", "Anytype-Version":"2025-11-08"}' \
  -s user -- npx -y @anyproto/anytype-mcp

</details>

Example Interactions

Here are some examples of how you can interact with your Anytype:

"Create a new space called 'Project Ideas' with description 'A space for storing project ideas'"
"Add a new object of type 'Task' with title 'Research AI trends' to the 'Project Ideas' space"
"Create a second one with title 'Dive deep into LLMs' with due date in 3 days and assign it to me"
"Now create a collection with the title "Tasks for this week" and add the two tasks to that list. Set due date of the first one to 10 days from now"

Development

Installation from Source

Clone the repository:

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

Install dependencies:

npm install -D

Build the project:

npm run build

Link the package globally (optional):

npm link

Contribution

Thank you for your desire to develop Anytype together!

❤️ This project and everyone involved in it is governed by the Code of Conduct.

🧑‍💻 Check out our contributing guide to learn about asking questions, creating issues, or submitting pull requests.

🫢 For security findings, please email security@anytype.io and refer to our security guide for more information.

🤝 Follow us on Github and join the Contributors Community.

Made by Any — a Swiss association 🇨🇭

Licensed under MIT.