API, Developer Portal & MCP!

News
,
1

Dear Developers!

We’re excited to announce the launch of the official Anytype API - built to help you extend, integrate and customize your Anytype experience.

To support this release, we’ve also launched a dedicated Developer Portal and our official MCP Server. These tools will help you create faster, collaborate better and push your workflows forward.

Check out the short demo videos below for a quick introduction:

API & Developer Portal Overview

MCP Server Introduction

Get started here:

GitHub repositories:

To try the API in action, make sure you’re using the latest version of Anytype.

And of course, we’ve also included a few additional improvements and fixes. Check out the full release notes here:

We’re looking forward to seeing what you create. Happy coding!

3

MCP support was unexpected but very welcomed.

4

Yay API finally!
Also I love the pixel characters on the developer page :smiling_face_with_three_hearts:

5

Has anyone succeeded? What tool did you use? Neither cursor nor cherry worked. :sweat_smile:

6

Great news! I hope there will be many extensions that will make using Anytype more productive and much more useful for the end user.

7

hey @yuanbo128, do you mind sharing what exactly isn’t working? i just tested it again in cursor after pasting the config into mcp.json - works fine:

Screenshot 2025-05-27 at 6.26.26 PM
Screenshot 2025-05-27 at 6.26.26 PM3248×2124 541 KB

8

Jannis is so cute! He looks like a ray of sunshine :face_holding_back_tears: thanks for making the demo vids for us!

Other than that, I cannot EXPLAIN how exciting this is! I’m going to spend hours on this! THANK YOU ANYTEAM WE LOVE YOU TO THE MOON AND BACK :white_heart::white_heart:

9

I’ll be extremely grateful if someone extend projects ant tasks with reminder and repetitive functionality; also, a progress bar for subtask execution; import date from Goodreads and some movie DB…
There is so much room to expand the functionalities and add new ones!

I’m so excited! :partying_face: :folded_hands:

10

Will there be a marketplace for extensions?

11

Very exciting!! Can finally say it: bye bye N*tion :smiling_face_with_sunglasses::smiling_face_with_sunglasses:

12

hello Jannis! Thank you for your reply, which gave me hope. I know you care about AnyType as much as I do. I am using Windows 10 and the cursor version is 0.50.7. Below is my JSON. Can you help me find out what is wrong? This is copied directly from AnyType config.

image
image1112×144 8.77 KB

13

This is amazing! Thank you team, I can’t wait to see what people do with this :grinning_face_with_smiling_eyes:

Just as a side note for anyone else who has trouble following the Raycast MCP setup video: make sure you already copied the MCP config when you click “Install server”. It auto-fills if there’s JSON in your clipboard.

14

Hi developers,

Thanks for the exciting release of the Anytype API and MCP Server! I’m already experimenting with the new tools and they look very promising.

I have a question about workspace management with the MCP Server. Currently, I’m working with multiple spaces in my Anytype setup, and I’d like to know:

Is there a way to configure a default space for MCP operations?

Ideally, when I don’t explicitly specify a space in my MCP commands, I’d like the server to automatically target one of my spaces as the default.

15

hi @langtind, this isn’t officially supported yet; however, it can be explored if there are more requests for this. as a workaround, you can achieve the behaviour to some extent by adding custom instructions in your mcp client, e.g:

IMPORTANT: Always use the space named “Vector Search Demo” with ID “bafyreifc5pbt3mupyjzagadii7qcdqopwm6idu7ywkltcr2lpk3bbg2gt4.scoxzd7vu6rz”. This MUST always be followed unless explicitly specified differently.

this gives a hint into the right direction

Screenshot 2025-05-28 at 3.58.19 PM
Screenshot 2025-05-28 at 3.58.19 PM1920×1247 137 KB

16

Hi, I’m trying to install MCP. I’m not a developer, but I think I’m getting close. I’m having trouble with the client: Error 32000 - Connection Closed.

Any ideas?

17

hey @aldobrandao, make sure you have anytype v0.46.7 or later running while setting it up & connecting. try again by copying the config directly from the api keys settings

if it still doesn’t work, let me know which mcp client you’re using

18

@yuanbo128 hey again, the config itself looks alright.

to debug this further, please share a screenshot of the same view i’ve posted in my previous answer, where we can see the available mcp servers. also, try with a chat on the right to ask something like “which anytype spaces do i have?”

19

Great news that the API is public, thanks guys!

I am getting the same issue with the MCP server and claude desktop that has been reported on here unfortunately :frowning:

Running windows 10 and up-to-date anytype/claude

EDIT:

Let me try to be a little more helpful lol.

Here’s my claude config:

 "anytype": {
      "command": "npx",
      "args": [
        "-y",
        "@anyproto/anytype-mcp"
      ],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer <KEY>\", \"Anytype-Version\":\"2025-05-20\"}"
      }
    },

This is copy/pasted from the API Keys section of the anytype desktop app.

Here’s the error log I’m getting from claude desktop:

2025-05-28T17:46:25.404Z [anytype] [info] Initializing server...
2025-05-28T17:46:25.495Z [anytype] [info] Server started and connected successfully
2025-05-28T17:46:25.527Z [anytype] [info] Message from client: {"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"claude-ai","version":"0.1.0"}},"jsonrpc":"2.0","id":0}
(node:3208) [DEP0040] DeprecationWarning: The `punycode` module is deprecated. Please use a userland alternative instead.
(Use `node --trace-deprecation ...` to show where the warning was created)
2025-05-28T17:46:29.306Z [anytype] [info] Server transport closed
2025-05-28T17:46:29.306Z [anytype] [info] Client transport closed
2025-05-28T17:46:29.306Z [anytype] [info] Server transport closed unexpectedly, this is likely due to the process exiting early. If you are developing this MCP server you can add output to stderr (i.e. `console.error('...')` in JavaScript, `print('...', file=sys.stderr)` in python) and it will appear in this log.
2025-05-28T17:46:29.307Z [anytype] [error] Server disconnected. For troubleshooting guidance, please visit our [debugging documentation](https://modelcontextprotocol.io/docs/tools/debugging) {"context":"connection"}
2025-05-28T17:46:29.307Z [anytype] [info] Client transport closed

Here’s my anytype version:
0.46.8

20

thanks @wethegreenpeople, i’m looking into this and will get back to you