Zotero MCP Server
by kujengaio.github.kujenga/zotero-mcpv0.3.1
Search your Zotero library, retrieve item metadata, and read full text from AI assistants.
context tax
queued
security
queued
cold start
queued
freshness
Maintained2mo ago
Install Zotero MCP server
Install in Claude Code
claude mcp add zotero-kujenga -e ZOTERO_API_KEY='<zotero-api-key>' -- uvx zotero-mcpInstall in Cursor
{
"mcpServers": {
"zotero-kujenga": {
"command": "uvx",
"args": [
"zotero-mcp"
],
"env": {
"ZOTERO_API_KEY": "<zotero-api-key>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"zotero-kujenga": {
"command": "uvx",
"args": [
"zotero-mcp"
],
"env": {
"ZOTERO_API_KEY": "<zotero-api-key>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"zotero-kujenga": {
"type": "stdio",
"command": "uvx",
"args": [
"zotero-mcp"
],
"env": {
"ZOTERO_API_KEY": "<zotero-api-key>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"zotero-kujenga": {
"command": "uvx",
"args": [
"zotero-mcp"
],
"env": {
"ZOTERO_API_KEY": "<zotero-api-key>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| ZOTERO_LOCAL | — | — | Use the local API from the Zotero desktop app instead of the Web API. Requires Zotero to be running with 'Allow other applications on this computer to communicate with Zotero' enabled under Settings > Advanced. |
| ZOTERO_API_KEY | — | yes | Zotero Web API key from https://www.zotero.org/settings/keys. Not required when ZOTERO_LOCAL is true. |
| ZOTERO_LIBRARY_ID | — | — | Zotero library ID (your user ID for user libraries). Not required when ZOTERO_LOCAL is true. |
| ZOTERO_LIBRARY_TYPE | — | — | Whether ZOTERO_LIBRARY_ID refers to a user or group library. |
Freshness
Maintained — last maintenance signal 2mo ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-08-07 · 2mo ago · GitHub
Latest release
2026-08-07 · 2mo ago · GitHub · 0.3.1
Package published
no data · npm/PyPI
Registry entry updated
2026-08-07 · 2mo ago · official registry · v0.3.1
FAQ
›How do I install the Zotero MCP server in Claude Code?
Run: claude mcp add zotero-kujenga -e ZOTERO_API_KEY='<zotero-api-key>' -- uvx zotero-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Zotero require an API key?
Yes. It expects ZOTERO_API_KEY, of which 1 is a secret.
›Can I use Zotero as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Zotero in the official MCP registry?
Yes, as io.github.kujenga/zotero-mcp.