PyzoteroSAFE
A Model Control Protocol (MCP) connector for integrating your local Zotero with Claude
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
[!IMPORTANT] This project is retired. I am no longer convinced MCP is the interface one wants, better have direct CLI access. If you like MCPs, there are a few options, but I did not test them. - zotero-mcp - zotero-mcp-server - mcp-zotero
A Model Control Protocol (MCP) connector for integrating your local Zotero with Claude. This enables direct read access to your local Zotero library through Claude's Desktop interface. It depends on the ability to access a local web-api in Zotero 7.
This was inspired by a repository using Node.js and the web api: mcp-zotero. This builds on the shoulders of the fantastic pyzotero library.
Installation
Run from local code (Recommended)
Information about Claude Desktop interacting with MCPs can be found here.
- Use
uv. Installation instructions can be found here.
- Checkout the git project to local space and activate the virtual environment inside:
git clone https://github.com/gyger/mcp-pyzotero.git cd mcp-pyzotero uv sync
- Enable the local API in Zotero 7:
- Add the server to your local Claude installation:
uv run mcp install zotero.py
Run encapsulated with uvx (Should work)
Edit the configuration for your Claude Desktop softare in the file.
- macOS: ~/Library/Application Support/Claude/claudedesktopconfig.json
- Windows: %APPDATA%\Claude\claudedesktopconfig.json
and add the Zotero entry
{
"mcpServers": {
"Zotero": {
"command": "uvx",
"args": ["--from", "git+https://github.com/gyger/mcp-pyzotero.git",
43b52828ea41OBSERVED · 2026-10-08Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control.
claude mcp add mcp-pyzotero -- uvx mcp-pyzotero
{
"mcpServers": {
"mcp-pyzotero": {
"command": "uvx",
"args": [
"mcp-pyzotero"
]
}
}
}Exposed tools (2)
2 read · 0 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
get_collection_items | read | |
get_item_fulltext | read |
Trust audit
SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | PASS |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | WARN |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- none-observed
- Network
- declared (5 observation(s))
- Shell
- none-observed
- Dependencies
- pinned
- Secrets in source
- none-found
Findings (1)
streamable-http
Gates applied: no_behavioural_pass.
43b52828ea41full audit observations/trust-audit/mcp-server/gyger__pyzotero.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-08 | 43b52828ea41 | SAFE | B | 89 | first audit |
Questions
What is the Pyzotero MCP server?
A Model Control Protocol (MCP) connector for integrating your local Zotero with Claude
What tools does Pyzotero expose?
2 in total: 2 read-only, 0 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is Pyzotero safe to connect to an agent?
The audit found nothing in the source that contradicts what it says it does, and graded it B (89/100). Grade A is held back for packages that have also passed a sandboxed behavioural run, which is why a clean server reads B.
What credentials does Pyzotero need?
No credential environment variables were found in its source, so it appears to need none.
How does Pyzotero run?
It speaks streamable-http, so it runs as a service you connect to over the network. It is published on PyPI as mcp-pyzotero.
How current is this page?
The grade is for one exact copy of the source (43b52828ea41), read on 2026-10-08. The repository is watched and re-audited when it changes.