# Reported issues for anytype-mcp

Pod holds 22 of 26 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to [anytype-mcp](/mcp/anytype-mcp).

## Most discussed

### Feature request: Way to specify the http api endpoint

### Have you read a contributing guide?

- [x] I have read CONTRIBUTING.md
- [x] I have searched the existing requests and didn't find any that were similar
- [x] I have considered creating a pull request instead and want to proceed

### Clear and concise description of the problem

The anytype-cli starts the http server on port 31012, but anytype-mcp looks for 31009. It would be great to be able to specify the endpoint through an environment variable.

### Suggested solution

Something like thi

[Read the thread](https://github.com/anyproto/anytype-mcp/issues/36) · 2026-02-10 · closed · external user · 3 comments

### Cannot create rich mentions via MCP that e.g. render a task with a checkbox

### Have you read a contributing guide?

- [x] I have read CONTRIBUTING.md
- [x] I have searched the existing issues and didn't find any that were similar
- [x] I have considered creating a pull request with fixes instead of a bug report and want to proceed

### Current Behavior

If I have my MCP write a link to a task to a page, it shows up as a plain underlined link

If I type `@` to look up the same task and link it, I get a rich embed with the checkbox

To the MCP client both look exactly th

[Read the thread](https://github.com/anyproto/anytype-mcp/issues/31) · 2026-01-29 · open · external user · 3 comments

### Include the delete method

### Have you read a contributing guide?

- [x] I have read CONTRIBUTING.md
- [x] I have searched the existing requests and didn't find any that were similar
- [x] I have considered creating a pull request instead and want to proceed

### Clear and concise description of the problem

Hi, thank you for providing this mcp server, its been really helpful!

I have been using AnyType for documenting my application, and recently started automating it with claude code. That said so, it's a bit difficult

[Read the thread](https://github.com/anyproto/anytype-mcp/issues/12) · 2025-08-14 · closed · external user · 3 comments

### 500 and 401 error after submitting any request

### Have you read a contributing guide?

- [x] I have read CONTRIBUTING.md
- [ ] I have searched the existing issues and didn't find any that were similar
- [x] I have considered creating a pull request with fixes instead of a bug report and want to proceed

### Current Behavior

After installing the MCP server in several AI chat UI programs, I am unable to use the server to communicate with Anytype. It returns a 401 and 500 error, despite using the "Copy MCP Config" option in Anytype directly. 

[Read the thread](https://github.com/anyproto/anytype-mcp/issues/10) · 2025-08-04 · closed · external user · 3 comments

### MCP works time to time

### Have you read a contributing guide?

- [x] I have read CONTRIBUTING.md
- [x] I have searched the existing issues and didn't find any that were similar
- [x] I have considered creating a pull request with fixes instead of a bug report and want to proceed

### Current Behavior

I am using MCP Server from AnythingLLM using Mistral 8B latest. 
I was able to test using the first example given: 
"Create a new space called 'Project Ideas' with description 'A space for storing project ideas'" using 

[Read the thread](https://github.com/anyproto/anytype-mcp/issues/7) · 2025-07-22 · closed · external user · 4 comments

### Connecting to Anytype API failing

### Have you read a contributing guide?

- [x] I have read CONTRIBUTING.md
- [x] I have searched the existing issues and didn't find any that were similar
- [x] I have considered creating a pull request with fixes instead of a bug report and want to proceed

### Current Behavior

Trying to use the MCP, not working  
MCP Anytype is correctly installed 
Re-installed completely Anytype Desktop application - 0.47.5
Anytype API is executing on port 31009 - anytypeHe 1976 myself   63u  IPv4 0x1cd5f466

[Read the thread](https://github.com/anyproto/anytype-mcp/issues/6) · 2025-07-11 · closed · external user · 5 comments

### Not working with cursor

### Have you read a contributing guide?

- [x] I have read CONTRIBUTING.md
- [x] I have searched the existing issues and didn't find any that were similar
- [x] I have considered creating a pull request with fixes instead of a bug report and want to proceed

### Current Behavior

<img width="548" alt="Image" src="https://github.com/user-attachments/assets/a074a0b9-e53f-437b-9c26-07742bfcb26b" />

<img width="712" alt="Image" src="https://github.com/user-attachments/assets/e8e40510-7aec-4e17-90e3

[Read the thread](https://github.com/anyproto/anytype-mcp/issues/5) · 2025-06-25 · closed · external user · 5 comments

### localhost resolves To ::1, breaking the MCP

### Have you read a contributing guide?

- [x] I have read CONTRIBUTING.md
- [x] I have searched the existing issues and didn't find any that were similar
- [x] I have considered creating a pull request with fixes instead of a bug report and want to proceed

### Current Behavior

The usage of `localhost` instead of `127.0.0.1` is causing the code to fail to connect to the API on my MBP, which is resolving `localhost` to `::1` (IPv6). I cloned the repo, replaced all instances of `localhost` with 

[Read the thread](https://github.com/anyproto/anytype-mcp/issues/4) · 2025-06-12 · closed · external user · 7 comments

## Most recent

### update-object markdown body is destructive: object markdown export→import round-trip is not idempotent

### Have you read a contributing guide?

- [x] I have read CONTRIBUTING.md
- [x] I have searched the existing issues and didn't find any that were similar
- [x] I have considered creating a pull request with fixes instead of a bug report and want to proceed

### Current Behavior

Reading an object as markdown (GET .../objects/{id}?format=md) and writing that exact same string back via update-object does not reproduce the object. Text is preserved, but the block structure/formatting of the whole 

[Read the thread](https://github.com/anyproto/anytype-mcp/issues/128) · 2026-07-17 · open · external user · 0 comments

### Expose inline object discussions via the chat API

### Have you read a contributing guide?

- [x] I have read CONTRIBUTING.md
- [x] I have searched the existing requests and didn't find any that were similar
- [x] I have considered creating a pull request instead and want to proceed

### Clear and concise description of the problem

When an Anytype object has an inline discussion (the chat panel attached to a note or page), it's currently not accessible via the MCP API.

Calling GET /v1/spaces/{space_id}/chats/{object_id}/messages using the obje

[Read the thread](https://github.com/anyproto/anytype-mcp/issues/115) · 2026-06-16 · open · external user · 0 comments

### Claude code brute-forces the API

### Have you read a contributing guide?

- [x] I have read CONTRIBUTING.md
- [x] I have searched the existing issues and didn't find any that were similar
- [x] I have considered creating a pull request with fixes instead of a bug report and want to proceed

### Current Behavior

Claude code does not know how to call the API correctly and sometimes just tries to brute force the API so that it finally gets what it wants. This seems wasteful and a bit of an antipattern as it can result in batch op

[Read the thread](https://github.com/anyproto/anytype-mcp/issues/108) · 2026-05-25 · open · external user · 1 comment

### Are block-level REST endpoints planned? (for rich content creation)

### Have you read a contributing guide?

- [x] I have read CONTRIBUTING.md
- [x] I have searched the existing requests and didn't find any that were similar
- [x] I have considered creating a pull request instead and want to proceed

### Clear and concise description of the problem

## Context

The official anytype-mcp does a great job with object-level operations via the REST API. I understand the project is REST-only.

## The gap

Currently there's no way for an AI assistant to create actual p

[Read the thread](https://github.com/anyproto/anytype-mcp/issues/105) · 2026-05-22 · open · external user · 2 comments

### Support inserting/updating Relation blocks in object body, not only markdown/properties

### Feature request

Please add MCP support for inserting and updating real Anytype Relation blocks inside an object's page body.

Currently, the MCP/REST wrapper can read and update objects, object properties, types, and markdown body content. However, there does not appear to be a tool/API operation for inserting an actual editable Relation block into the object body.

This makes it impossible for an MCP client to reproduce the common Anytype template layout where relation fields are shown at 

[Read the thread](https://github.com/anyproto/anytype-mcp/issues/103) · 2026-05-17 · open · external user · 1 comment

### list-objects and search-space time out from Calude Desktop / API returns Transfer-Encoding: chunked with no Content-Length

### Have you read a contributing guide?

- [x] I have read CONTRIBUTING.md
- [x] I have searched the existing issues and didn't find any that were similar
- [x] I have considered creating a pull request with fixes instead of a bug report and want to proceed

### Current Behavior

list-objects and search-space consistently time out when called via Claude desktop MCP. No response is ever received by the MCP client.
Direct HTTP calls to the same endpoints work correctly in PowerShell (41ms response

[Read the thread](https://github.com/anyproto/anytype-mcp/issues/98) · 2026-05-11 · closed · external user · 1 comment

### Claude through MCP can't Create task items in a Task object

### Have you read a contributing guide?

- [x] I have read CONTRIBUTING.md
- [x] I have searched the existing issues and didn't find any that were similar
- [x] I have considered creating a pull request with fixes instead of a bug report and want to proceed

### Current Behavior

I have asked Claude to create a task object and add three tasks. It has tried many times and insists this is a bug:
The instructions specifically mention creating tasks:

"Add a new object of type 'Task' with title 'Res

[Read the thread](https://github.com/anyproto/anytype-mcp/issues/93) · 2026-05-01 · open · external user · 0 comments

### API-create-object and other write tools unavailable due to FilterExpression ref resolution failure

### Have you read a contributing guide?

- [x] I have read CONTRIBUTING.md
- [x] I have searched the existing issues and didn't find any that were similar
- [x] I have considered creating a pull request with fixes instead of a bug report and want to proceed

### Current Behavior

## Summary

When launching the MCP server via `npx`, `API-create-object`, `API-update-object`,
and `API-search-space` are silently excluded from the available tool set.
The server starts without a fatal error, but write

[Read the thread](https://github.com/anyproto/anytype-mcp/issues/92) · 2026-05-01 · open · external user · 0 comments

### Created objects are not persisted in Anytype app

### Have you read a contributing guide?

- [x] I have read CONTRIBUTING.md
- [x] I have searched the existing issues and didn't find any that were similar
- [x] I have considered creating a pull request with fixes instead of a bug report and want to proceed

### Current Behavior

## Description

When using `API-create-object` to create new objects (Note or Page), the API returns a success response with an object ID, but the created objects do not appear in the Anytype app or in subsequent `API-l

[Read the thread](https://github.com/anyproto/anytype-mcp/issues/91) · 2026-04-30 · closed · external user · 1 comment

### Feature Request: Add `get_object` Tool / API Endpoint

### Have you read a contributing guide?

- [x] I have read CONTRIBUTING.md
- [x] I have searched the existing requests and didn't find any that were similar
- [x] I have considered creating a pull request instead and want to proceed

### Clear and concise description of the problem

### Summary
The MCP server currently lacks a way to retrieve a single Anytype object by its ID. 
This makes it impossible to resolve linked objects referenced in properties like `links` 
or `backlinks`, severely limi

[Read the thread](https://github.com/anyproto/anytype-mcp/issues/73) · 2026-04-02 · closed · external user · 2 comments

### Auto-launch Anytype desktop app on ECONNREFUSED (local API only)

### Have you read a contributing guide?

- [x] I have read CONTRIBUTING.md
- [x] I have searched the existing requests and didn't find any that were similar
- [x] I have considered creating a pull request instead and want to proceed

### Clear and concise description of the problem

When the Anytype desktop application is not running and an MCP client calls any tool, the server currently fails silently or returns an opaque error. The user gets no actionable feedback and must manually diagnose t

[Read the thread](https://github.com/anyproto/anytype-mcp/issues/63) · 2026-03-11 · open · external user · 0 comments

### file-upload fails with gRPC ECONNREFUSED when Anytype desktop is running

## Description

When using `file-upload` tool to upload local files (images) to a space, the gRPC connection fails with `ECONNREFUSED 127.0.0.1:37355` even though the Anytype desktop app appears to be running.

The REST API works fine (e.g., `API-create-object` succeeds), but the gRPC-based `file-upload` fails.

## Steps to Reproduce

1. Have Anytype desktop app running
2. Use `file-upload` with a valid `space_id` and `local_path` to a JPEG image
3. Observe error

## Error

```json
{
  "status":

[Read the thread](https://github.com/anyproto/anytype-mcp/issues/58) · 2026-03-07 · open · external user · 1 comment

### CLI 'get-key' fails with 404 — uses deprecated endpoints

## Bug

The `npx @anyproto/anytype-mcp get-key` command fails with:
```
Authentication error: Request failed with status code 404
Error: Failed to start authentication
```

## Root Cause

In `src/auth/get-key.ts`, `startAuthentication()` calls `POST /v1/auth/display_code` which no longer exists:

```typescript
const response = await axios.post(`${this.basePath}/v1/auth/display_code`, null, {
  params: { app_name: this.appName },
});
```

And `completeAuthentication()` calls `POST /v1/auth/token`

[Read the thread](https://github.com/anyproto/anytype-mcp/issues/52) · 2026-03-01 · closed · external user · 1 comment

### Invalid $ref in schema: FilterExpression not defined - breaks Claude Code integration

### Have you read a contributing guide?

- [x] I have read CONTRIBUTING.md
- [x] I have searched the existing issues and didn't find any that were similar
- [x] I have considered creating a pull request with fixes instead of a bug report and want to proceed

### Current Behavior

❌ Server shows warning on startup: `Failed to resolve ref #/components/schemas/FilterExpression`
❌ Claude Code rejects the tool schema with a 400 error
❌ MCP commands are detected by Claude Code but do not work
❌ Breaks

[Read the thread](https://github.com/anyproto/anytype-mcp/issues/21) · 2026-01-07 · closed · external user · 1 comment

The remaining reports are on [the project's issue tracker](https://github.com/anyproto/anytype-mcp/issues).