# Reported issues for Zotero MCP

Pod holds 10 of 10 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 [Zotero MCP](/mcp/zotero-mcp).

## Most discussed

### Using in cherrystudio

how to use in cherrystudio with local Zotero data?

[Read the thread](https://github.com/kujenga/zotero-mcp/issues/20) · 2025-10-27 · closed · external user · 1 comment

### Number of items returned? Annotations? Local Zotero API?

I just learned about MCP servers today and my first thought was: is there one for Zotero? So, I'm glad that you started this project!

I have started testing it and want to share some thoughts/ impressions. Most of these things you are probably already aware of, but I'm sharing them to hear your thoughts):

- it looks like it limits the number of returned items to 10. Is that correct? For example, I asked "how many items do I have on the topic of X" and it told me there were 10 (even though ther

[Read the thread](https://github.com/kujenga/zotero-mcp/issues/16) · 2025-04-29 · open · external user · 1 comment

### The deployment is successful, but an error message is reported.

Error executing tool zotero_search_items: Server disconnected without sending a response.

I'm calling local zotero

[Read the thread](https://github.com/kujenga/zotero-mcp/issues/15) · 2025-04-29 · closed · external user · 4 comments

### Error retrieving item full text

When I use zotero_item_fulltext, there is a prompt：No endpoint found.
for example:

{
  "params": {
    "item_key": "GKLM5D6X"
  },
  "response": {
    "content": [
      {
        "type": "text",
        "text": "Error retrieving item full text: \nCode: 404\nURL: http://localhost:23119/api/users/0/items/6EFQTCTX/fulltext?locale=en-US&format=json&limit=100\nMethod: GET\nResponse: No endpoint found\n"
      }
    ],
    "isError": false
  }
}

[Read the thread](https://github.com/kujenga/zotero-mcp/issues/13) · 2025-04-20 · closed · external user · 3 comments

### solution to "Error: spawn uvx ENOENT"

FYI: In MacOS, the default uv installation doens't make uv available to the mcp server. Using `brew install uv` solves the issue.

[Read the thread](https://github.com/kujenga/zotero-mcp/issues/12) · 2025-04-01 · closed · external user · 2 comments

### Can I use this tool to insert new references?

or is it only for the equivalent of REST GET calls?

Thanks!

[Read the thread](https://github.com/kujenga/zotero-mcp/issues/11) · 2025-03-31 · open · external user · 2 comments

### Add Dockerfile and Docker instructions to improve accessibility

## Feature Request: Add Dockerfile and Docker Configuration

### Description
It would be helpful to add a Dockerfile and instructions on how to configure MCP for Docker, similar to other MCP servers. Having a Docker setup would make the project more accessible to a wider range of users, especially those who prefer containerized applications for easier deployment and environment consistency.

### Suggested Implementation
1. Create a Dockerfile that:
   - Uses an appropriate Python base image (3.1

[Read the thread](https://github.com/kujenga/zotero-mcp/issues/6) · 2025-03-29 · closed · external user · 2 comments

### 404 error for zotero_item_fulltext from zotero (local)

Hi

thanks for this MCP server.

Whenever I try to get the full text of an item using Claude desktop I get a 404 error as follows

```
View result from zotero_item_fulltext from zotero (local)

{
  `item_key`: `AJ2PQVLC`
}

Error retrieving item full text: 
Code: 404
URL: http://localhost:23119/api/users/0/items/45EHIJKU/fulltext?locale=en-US&format=json&limit=100
Method: GET
Response: No endpoint found
```

Can you help? The other tools seem to work just fine.

[Read the thread](https://github.com/kujenga/zotero-mcp/issues/3) · 2025-02-25 · closed · external user · 2 comments

## Most recent

### zotero : zotero_item_fulltext Runtime error, what is the cause?

<img width="1925" height="523" alt="Image" src="https://github.com/user-attachments/assets/af8a00ff-3d65-4b87-bded-db54110f6f6a" />
{
  "params": {
    "item_key": "46HQREV6"
  },
  "response": {
    "content": [
      {
        "type": "text",
        "text": "Error retrieving item full text: \nCode: 404\nURL: http://localhost:23119/api/users/0/items/46HQREV6/fulltext?format=json&limit=100&locale=en-US\nMethod: GET\nResponse: No endpoint found\n"
      }
    ],
    "structuredContent": {
      

[Read the thread](https://github.com/kujenga/zotero-mcp/issues/21) · 2025-12-07 · closed · external user · 1 comment

### FYI, How to enable Local Zotero API server.

In the lastest beta, the Local Zotero API server is not enabled by default.

Here is how to enable it.

1. Zotero Settings 
2. Advanced, scroll down to bottom
3. Config editor

**And set true.**

<img width="1112" alt="Image" src="https://github.com/user-attachments/assets/3c3b72da-ff2d-42ee-837d-66c791c8b2c2" />

[Read the thread](https://github.com/kujenga/zotero-mcp/issues/5) · 2025-03-29 · closed · external user · 1 comment

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