Zotero MCP Server
An MCP (Model Context Protocol) server that integrates with Zotero's local API to search, retrieve, read PDFs, and add items by DOI from your Zotero library.
Prerequisites
- Zotero application with local API enabled
- uv (recommended) or Python 3.12+
Enable Zotero Local API
In Zotero's settings (Preferences → Advanced → General), enable:
☑️ Allow other applications on this computer to communicate with Zotero
Configuration
Add the following to your MCP client configuration file (e.g., mcp.json for Claude Desktop or Cursor):
{
"mcpServers": {
"zotero": {
"command": "uvx",
"args": ["masaki39-zotero-mcp"]
}
}
}
Available Tools
| Tool | Parameters | Description |
|---|---|---|
zotero_search_items |
q (optional) |
Search items in your Zotero library by author name or title. Returns up to 30 matching items (excluding attachments). |
zotero_get_item |
itemKey (required) |
Retrieve detailed information about a specific item including title, authors, publication info, abstract, tags, etc. |
zotero_read_pdf |
itemKey (required), page_number (optional), attachment_index (optional, default=1) |
Extract text from a PDF attachment. Specify a page number to read a single page, or omit to read all pages. Use attachment_index to select among multiple PDFs. |
confirm_doi |
doi (required) |
Fetch metadata for a DOI from CrossRef. Use this to validate a DOI before adding it to Zotero. |
add_item_by_doi |
doi (required) |
Add an item to Zotero by DOI. Validates via CrossRef and checks for duplicates before adding. |
Example Usage
Once configured, you can use these tools through your MCP client:
- "Search my Zotero library for papers about spinal deformity"
- "Get details for item ABCD1234"
- "Read page 3 of the PDF attached to item ABCD1234"
- "Look up DOI 10.1038/s41586-021-03819-2 and add it to my Zotero library"
License
MIT License - see LICENSE file for details.
Contributing
Issues and pull requests are welcome at https://github.com/masaki39/zotero-mcp
Metadata
Release files for masaki39-zotero-mcp 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| masaki39_zotero_mcp-0.2.0.tar.gz | 7.5 kB | Without provenance | Details for masaki39_zotero_mcp-0.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| masaki39_zotero_mcp-0.2.0-py3-none-any.whl | Python 3 | none | any | Details for masaki39_zotero_mcp-0.2.0-py3-none-any.whl |
Total release size: 15.6 kB
Release files / masaki39_zotero_mcp-0.2.0.tar.gz
| Download URL | masaki39_zotero_mcp-0.2.0.tar.gz |
|---|---|
| Size | 7.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7966fe661f3baa5898f7c1014d28606d12d534429a138cbab679eeef91bc6aa6
|
|
BLAKE2b-256 checksum How to use checksums |
9204b52d1a5375821bc52c752373ada5d82ed8412b1c91d10bb073df2c61e58d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.10
|
Release files / masaki39_zotero_mcp-0.2.0-py3-none-any.whl
| Download URL | masaki39_zotero_mcp-0.2.0-py3-none-any.whl |
|---|---|
| Size | 8.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d96d8f143da9a6dd934555c503348efafb7c4e2c86e6e634fb71709dd6d9b79e
|
|
BLAKE2b-256 checksum How to use checksums |
771a0b83a77adc85aea598b8765343dcb0838ae056cefaceed981e0b27e54d31
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.10
|
Security for masaki39-zotero-mcp 0.2.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.