https://github.com/anyproto/anytype-mcp
An MCP server enabling AI assistants to interact with Anytype - your encrypted, local and collaborative wiki - to organize objects, lists, and more through natural language.
https://github.com/anyproto/anytype-mcp
anytype api mcp mcp-server modelcontextprotocol
Last synced: 20 days ago
JSON representation
An MCP server enabling AI assistants to interact with Anytype - your encrypted, local and collaborative wiki - to organize objects, lists, and more through natural language.
- Host: GitHub
- URL: https://github.com/anyproto/anytype-mcp
- Owner: anyproto
- License: mit
- Created: 2025-04-19T16:55:01.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2026-01-27T19:40:42.000Z (about 1 month ago)
- Last Synced: 2026-02-02T00:51:03.054Z (about 1 month ago)
- Topics: anytype, api, mcp, mcp-server, modelcontextprotocol
- Language: TypeScript
- Homepage: https://npmjs.com/package/@anyproto/anytype-mcp
- Size: 3.16 MB
- Stars: 276
- Watchers: 6
- Forks: 33
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-mcp - anyproto/anytype-mcp
- awesome-mcp-servers - **anytype-mcp** - An MCP server enabling AI assistants to interact with Anytype - a local and collaborative wiki - to organize objects, lists, and more through natural language. `typescript` `anytype` `api` `mcp` `mcp-server` `npm install anyproto/anytype-mcp` (🔌 API)
- toolsdk-mcp-registry - ❌ @anyproto/anytype-mcp - data while filtering out destructive operations. (node) (Other Tools and Integrations / How to Submit)
- awesome-mcp - anyproto/anytype-mcp - The Anytype MCP Server is a Model Context Protocol server that enables AI assistants to interact with Anytype's API through natural language, facilitating seamless knowledge base management. (MCP Servers / Knowledge & Memory)
README
# Anytype MCP Server
The Anytype MCP Server is a [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server enabling AI assistants to seamlessly interact with [Anytype's API](https://github.com/anyproto/anytype-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
1. Open Anytype
2. Go to App Settings
3. Navigate to API Keys section
4. Click on `Create new` button
Alternative: Get API key via CLI
You can also get your API key using the command line:
```bash
npx -y @anyproto/anytype-mcp get-key
```
### 2. Configure Your MCP Client
#### Claude Desktop, Cursor, Windsurf, Raycast, etc.
Add the following configuration to your MCP client settings after replacing `` with your actual API key:
```json
{
"mcpServers": {
"anytype": {
"command": "npx",
"args": ["-y", "@anyproto/anytype-mcp"],
"env": {
"OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer \", \"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 `` with your actual API key:
```bash
claude mcp add anytype -e OPENAPI_MCP_HEADERS='{"Authorization":"Bearer ", "Anytype-Version":"2025-11-08"}' -s user -- npx -y @anyproto/anytype-mcp
```
Alternative: Global Installation
If you prefer to install the package globally:
1. Install the package:
```bash
npm install -g @anyproto/anytype-mcp
```
2. Update your MCP client configuration to use the global installation:
```json
{
"mcpServers": {
"anytype": {
"command": "anytype-mcp",
"env": {
"OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer \", \"Anytype-Version\":\"2025-11-08\"}"
}
}
}
}
```
### 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`:
Example Configuration
**MCP Client (Claude Desktop, Cursor, etc.):**
```json
{
"mcpServers": {
"anytype": {
"command": "npx",
"args": ["-y", "@anyproto/anytype-mcp"],
"env": {
"ANYTYPE_API_BASE_URL": "http://localhost:31012",
"OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer \", \"Anytype-Version\":\"2025-11-08\"}"
}
}
}
}
```
**Claude Code (CLI):**
```bash
claude mcp add anytype \
-e ANYTYPE_API_BASE_URL='http://localhost:31012' \
-e OPENAPI_MCP_HEADERS='{"Authorization":"Bearer ", "Anytype-Version":"2025-11-08"}' \
-s user -- npx -y @anyproto/anytype-mcp
```
## 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
1. Clone the repository:
```bash
git clone https://github.com/anyproto/anytype-mcp.git
cd anytype-mcp
```
2. Install dependencies:
```bash
npm install -D
```
3. Build the project:
```bash
npm run build
```
4. Link the package globally (optional):
```bash
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](https://github.com/anyproto/.github/blob/main/docs/CODE_OF_CONDUCT.md).
🧑💻 Check out our [contributing guide](https://github.com/anyproto/.github/blob/main/docs/CONTRIBUTING.md) to learn about asking questions, creating issues, or submitting pull requests.
🫢 For security findings, please email [security@anytype.io](mailto:security@anytype.io) and refer to our [security guide](https://github.com/anyproto/.github/blob/main/docs/SECURITY.md) for more information.
🤝 Follow us on [Github](https://github.com/anyproto) and join the [Contributors Community](https://github.com/orgs/anyproto/discussions).
---
Made by Any — a Swiss association 🇨🇭
Licensed under [MIT](./LICENSE.md).