mcp-zotero
A connector for Claude Desktop to work with collection and sources on your Zotero Cloud. Built for the Model Context Protocol to enhance AI capabilities.
Documentation
MCP Zotero
A Model Context Protocol server for Zotero integration that allows Claude to interact with your Zotero library.
Setup
1. Get your Zotero credentials:
# First, create an API key at https://www.zotero.org/settings/keys
# Then use it to get your user ID:
curl -H "Zotero-API-Key: YOUR_API_KEY" https://api.zotero.org/keys/currentThe response will look like:
{
"userID": 123456,
"username": "your_username",
"access": {
"user": {
"library": true,
"files": true,
"notes": true,
"write": true
}
}
}The `userID` value is what you need.
2. Set environment variables:
export ZOTERO_API_KEY="your-api-key"
export ZOTERO_USER_ID="user-id-from-curl"3. Verify your credentials:
# Test that your credentials work:
curl -H "Zotero-API-Key: $ZOTERO_API_KEY" \
"https://api.zotero.org/users/$ZOTERO_USER_ID/collections"You should see your collections list in the response.
4. Install and run:
# Install globally (recommended)
npm install -g mcp-zotero
mcp-zotero
# Or run directly with npx
npx mcp-zoteroIntegration with Claude Desktop
To use this server with Claude Desktop, add the following to your Claude Desktop configuration:
{
"mcpServers": {
"zotero": {
"command": "mcp-zotero",
"env": {
"ZOTERO_API_KEY": YOUR_API_KEY,
"ZOTERO_USER_ID": YOUR_USER_ID
}
}
}
}Available Tools
- `get_collections`: List all collections in your library
- `get_collection_items`: Get items in a specific collection
- `get_item_details`: Get detailed information about a paper
- `search_library`: Search your entire library
- `get_recent`: Get recently added papers
Troubleshooting
If you encounter any issues:
1. Verify your environment variables are set:
echo $ZOTERO_API_KEY
echo $ZOTERO_USER_ID2. Check the installation:
npm list -g mcp-zotero3. Try reinstalling:
npm uninstall -g mcp-zotero
npm install -g mcp-zoteroFrequently asked questions
What is mcp-zotero?
mcp-zotero is A connector for Claude Desktop to work with collection and sources on your Zotero Cloud. Built for the Model Context Protocol to enhance AI capabilities.
How do I install mcp-zotero?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is mcp-zotero open source?
Yes — it is hosted on GitHub at https://github.com/kaliaboi/mcp-zotero and has 136 stars.
Related MCP tools
🍒 Cherry Studio is a desktop client that supports for multiple LLM providers. Built for the Model Context Protocol to enhance AI capabilities.
Enhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini...
FastGPT is a knowledge-based platform built on the LLMs, offers a comprehensive suite of out-of-the-box capabilities such as data processing, RAG retrieval, ...
Composio equips your AI agents & LLMs with 100+ high-quality integrations via function calling for the Model Context Protocol. Enhance AI assistants with powerf
📦 Repomix is a powerful tool that packs your entire repository into a single, AI-friendly file. Perfect for when you need to feed your codebase to Large Lan...
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Ag...
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP