MCP Zotero

1# MCP Zotero
2 
3![NPM Version](https://img.shields.io/npm/v/mcp-zotero) [![smithery badge](https://smithery.ai/badge/mcp-zotero)](https://smithery.ai/server/mcp-zotero)
4 
5A Model Context Protocol server for Zotero integration that allows Claude to interact with your Zotero library.
6 
7<a href="https://glama.ai/mcp/servers/mjvu0xzzzz"><img width="380" height="200" src="https://glama.ai/mcp/servers/mjvu0xzzzz/badge" alt="Zotero MCP server" /></a>
8 
9## Setup
10 
111. Get your Zotero credentials:
12 
13   ```bash
14   # First, create an API key at https://www.zotero.org/settings/keys
15   # Then use it to get your user ID:
16   curl -H "Zotero-API-Key: YOUR_API_KEY" https://api.zotero.org/keys/current
17   ```
18 
19   The response will look like:
20 
21   ```json
22   {
23     "userID": 123456,
24     "username": "your_username",
25     "access": {
26       "user": {
27         "library": true,
28         "files": true,
29         "notes": true,
30         "write": true
31       }
32     }
33   }
34   ```
35 
36   The `userID` value is what you need.
37 
382. Set environment variables:
39 
40   ```bash
41   export ZOTERO_API_KEY="your-api-key"
42   export ZOTERO_USER_ID="user-id-from-curl"
43   ```
44 
453. Verify your credentials:
46 
47   ```bash
48   # Test that your credentials work:
49   curl -H "Zotero-API-Key: $ZOTERO_API_KEY" \
50        "https://api.zotero.org/users/$ZOTERO_USER_ID/collections"
51   ```
52 
53   You should see your collections list in the response.
54 
554. Install and run:
56 
57   ```bash
58   # Install globally (recommended)
59   npm install -g mcp-zotero
60   mcp-zotero
61 
62   # Or run directly with npx
63   npx mcp-zotero
64   ```
65 
66## Integration with Claude Desktop
67 
68To use this server with Claude Desktop, add the following to your Claude Desktop configuration:
69 
70```json
71{
72  "mcpServers": {
73    "zotero": {
74      "command": "mcp-zotero",
75      "env": {
76        "ZOTERO_API_KEY": YOUR_API_KEY,
77        "ZOTERO_USER_ID": YOUR_USER_ID
78      }
79    }
80  }
81}
82```
83 
84## Available Tools
85 
86- `get_collections`: List all collections in your library
87- `get_collection_items`: Get items in a specific collection
88- `get_item_details`: Get detailed information about a paper
89- `search_library`: Search your entire library
90- `get_recent`: Get recently added papers
91 
92## Troubleshooting
93 
94If you encounter any issues:
95 
961. Verify your environment variables are set:
97 
98   ```bash
99   echo $ZOTERO_API_KEY
100   echo $ZOTERO_USER_ID
101   ```
102 
1032. Check the installation:
104 
105   ```bash
106   npm list -g mcp-zotero
107   ```
108 
1093. Try reinstalling:
110   ```bash
111   npm uninstall -g mcp-zotero
112   npm install -g mcp-zotero
113   ```
114