Zotero MCP Server
Capped at 70: core tools not tested: no backing service on the test box; the tests add up to 93. Why scores are capped
Test points add up to 93; the score is capped at 70 until a tool call passes. Not a quality or security rating. Methodology
Test points before the cap (93/100)
- Install20/20
- Handshake30/30
- Maintenance25/25
- Docs15/15
- License3/10
Tested pypi zotero-mcp-server 0.17.2 (MIT AND AGPL-3.0-or-later; repo 54yyyu/zotero-mcp). Installed pinned with scripts off (uv venv, Python 3.13) and launched: initialize and tools/list over stdio succeeded with no credentials and listed 35 tools (no tool annotations). Real calls: 0 of 3 real function calls passed. No passing real call: needs the Zotero desktop app running. Core tools not tested: 70 cap.
Tool-call test (2026-11-18 UTC, direct MCP stdio client, no LLM): fail. 0 of 3 real function calls passed. No passing real call: needs the Zotero desktop app running. Evidence: local test run, Nov 18, 2026 UTC.
Transport (tested 2026-11-18 UTC): stdio
Token cost (estimate): approx. 6428 tokens, cl100k estimate (35 tools, measured 2026-11-18 UTC, version 0.17.2). This is an estimate from our testing of the tool names, descriptions and input schemas, counted with cl100k_base.
Permissions: 17 read, 15 write (state-changing), 3 unclassified · Auth: none · Rate limit: unknown · Pricing unit: unknown
Auth: none. Rate limit: unknown. Pricing unit: unknown.
zotero_add_item— write (state-changing)zotero_advanced_search— readzotero_attach_file— write (state-changing)zotero_authorize_local_writes— write (state-changing)zotero_batch_update— write (state-changing)zotero_create_annotation— write (state-changing)zotero_delete_annotation— write (state-changing)zotero_delete_item— write (state-changing)zotero_export_bibliography— unclassifiedzotero_get_annotations— readzotero_get_attachment_path— readzotero_get_collection_items— readzotero_get_collections— readzotero_get_item_children— readzotero_get_item_fulltext— readzotero_get_item_metadata— readzotero_get_notes— write (state-changing)zotero_get_page_layout— readzotero_get_pdf_outline— readzotero_get_recent— readzotero_get_tags— readzotero_list_libraries— readzotero_manage_collection— write (state-changing)zotero_manage_note— write (state-changing)zotero_read_pdf_pages— readzotero_search_by_citation_key— readzotero_search_collections— readzotero_search_items— readzotero_set_item_collections— write (state-changing)zotero_set_item_parent— write (state-changing)zotero_switch_library— unclassifiedzotero_synthesize_annotations— unclassifiedzotero_update_annotation— write (state-changing)zotero_update_item— write (state-changing)zotero_write_capabilities— write (state-changing)
handshake and tools listed without a recorded key or OAuth
Score 70/100 · Tools 35 · Token cost approx. 6,428 tokens · Compare · Last tested 2026-11-18 UTC · Version tested 0.17.2 · Package zotero-mcp-server · Repo 54yyyu/zotero-mcp
Summary: Zotero MCP Server completed an MCP handshake without credentials and exposed 35 tools.
Evidence summary
- Handshake
- pass
- Tools listed
- 35
- Context cost
- approx. 6428 tokens, cl100k estimate (35 tools, measured 2026-11-18 UTC, version 0.17.2; an estimate) ranking · add up your servers' context cost
- API key
- No key to connect (handshake passed)
- Tested
- 2026-11-18 UTC
Test results
| Test | Result | Points | Evidence |
|---|---|---|---|
| install | pass | 20 | uv pip install zotero-mcp-server (Python venv, Linux) succeeded in 1s. |
| handshake | pass | 30 | MCP initialize + tools/list over stdio succeeded with no credentials; 35 tools listed in 5.0s. |
| maintenance | pass | 25 | Repo pushed 3 days before test; 5,963 GitHub stars. |
| docs | pass | 15 | README over 3,000 chars; install instructions present; mcpServers config example present. Check of the package's own README (PyPI long_description (package README)). |
| license | partial | 3 | License not machine-detected as OSI (MIT AND AGPL-3.0-or-later). |
Local-model readiness
Token cost (estimate): approx. 6428 tokens, cl100k estimate for 35 tools · about 78% of an 8k context. This is an estimate from our testing (counted with cl100k_base).
Small-model friendly (schema heuristic, not a model result): unknown.
Not tested
Small-model task runs: Not yet tested.
What we tested and what we didn't
Tested on 2026-11-18 UTC
- Install from the registry
- We connected with no credentials and asked for its tool list: it listed 35 tools (Method details: MCP
initializethentools/list) - Maintenance signals (last push, archived/deprecated status)
- Docs (README length, install and config example)
- License (OSI-approved or not)
- Token cost (estimate)
Not tested
- Security: not audited (no code review, no permission or data-flow analysis)
- Real tasks (no functional task runs yet)
- Behaviour with real credentials or a real account
- Performance, rate limits or load
- Correctness of results beyond the listed tasks
Methodology: how we test. A high score means it installs and responds, not that giving it access to your data carries no risk.
Known security issues
Not yet checked.
Monthly roundup: MCP security issues, October 2026.
Tool list changes
Baseline recorded from the 2026-11-18 UTC test run; changes appear after the next test.
Note: tool list can depend on the connected database, so changes are annotated, not flagged automatically.
Snapshot hash (fingerprint of the tool list)
76ad7405d449: SHA-256 of the canonical tool names, descriptions and input schemas. If it changes, the tool list changed.
Raw test record (JSON)
{
"name": "zotero-mcp-server",
"version": "0.17.2",
"registry": "pypi",
"status": "working",
"tested": "2026-11-18",
"tools_count": 35,
"deprecated": false,
"archived": false,
"tests": {
"install": [
"pass",
20,
"`uv pip install zotero-mcp-server` (Python venv, Linux) succeeded in 1s."
],
"handshake": [
"pass",
30,
"MCP `initialize` + `tools/list` over stdio succeeded with no credentials; 35 tools listed in 5.0s."
],
"maintenance": [
"pass",
25,
"Repo pushed 3 days before test; 5,963 GitHub stars."
],
"docs": [
"pass",
15,
"README over 3,000 chars; install instructions present; `mcpServers` config example present. Check of the package's own README (PyPI long_description (package README))."
],
"license": [
"partial",
3,
"License not machine-detected as OSI (MIT AND AGPL-3.0-or-later)."
]
},
"testedAt": "2026-11-18T04:18:11.653Z"
}Install
uvx zotero-mcp-server
Pin the version we tested
uvx zotero-mcp-server==0.17.2
pip install zotero-mcp-server==0.17.2
tested 2026-11-18 UTC. Newer versions may differ and were not tested by us.
{
"mcpServers": {
"zotero-mcp-server": {
"command": "uvx",
"args": [
"zotero-mcp-server==0.17.2"
]
}
}
}Tools listed
zotero_get_annotations, zotero_get_notes, zotero_manage_note, zotero_create_annotation, zotero_get_page_layout, zotero_update_annotation, zotero_delete_annotation, zotero_get_item_metadata, zotero_get_item_fulltext, zotero_get_attachment_path, zotero_get_collections, zotero_get_collection_items, zotero_get_item_children, zotero_get_tags, zotero_list_libraries, zotero_switch_library, zotero_get_recent, zotero_set_item_parent, zotero_authorize_local_writes, zotero_write_capabilities, zotero_read_pdf_pages, zotero_search_items, zotero_search_by_citation_key, zotero_advanced_search, zotero_synthesize_annotations, zotero_export_bibliography, zotero_batch_update, zotero_manage_collection, zotero_search_collections, zotero_set_item_collections, zotero_update_item, zotero_delete_item, zotero_get_pdf_outline, zotero_attach_file, zotero_add_item
Quick config
{
"mcpServers": {
"zotero-mcp-server": {
"command": "uvx",
"args": [
"zotero-mcp-server"
]
}
}
}Add to config Opens the config generator with this server selected.
Setup
- Install. Run
uv pip install zotero-mcp-server(Python venv). This is the exact command we ran on 2026-11-18 UTC. - Configure. Add the mcpServers entry below to your MCP client config.
- Verify. Restart the client and check that tools/list returns tools (35 in our test).
{
"mcpServers": {
"zotero-mcp-server": {
"command": "uvx",
"args": [
"zotero-mcp-server"
]
}
}
}Test history
- 2026-11-18 UTC: New
Related: Best database MCP servers
FAQ
Is Zotero MCP Server deprecated?
No. Zotero MCP Server was not deprecated or archived when we last tested it on 2026-11-18 UTC.
What replaces Zotero MCP Server?
Nothing; Zotero MCP Server is not deprecated as of 2026-11-18 UTC.
Does Zotero MCP Server need an API key?
No. It completed an MCP handshake with no credentials and listed 35 tools.
Embed the badge
Every tested server gets a free embeddable badge. It shows the current score and test date and expires after 90 days. Testing is free; payment never changes a score.