Skip to main content

zotero_mcp

English | 中文

Support connecting Zotero via MCP with a custom server and client, without the need for tools like the Claude app or Cursor.

Environment configuration

conda create -n mcp python=3.12 -y
conda activate mcp
pip install -r requirements.txt

Run MCP

First, create a .env file and fill in the following variables. zotero_api_key needs to be obtained from the Zotero official website, and api_key is your LLM's API key:

zotero_api_key=''
api_key=""

First, create a .env file and fill in the following variables:

model=""  
llm_api_base = ""  
llm_api_key=""  
zotero_api_key=''  
library_id=''  

model is the name of the LLM, llm_api_base is the URL of the LLM, and llm_api_key is the API Key for the LLM. The zotero_api_key can be created by visiting the Zotero, and your library_id is shown below:
library_id

Then start the server:

python ./server.py

Open a new terminal window and run the client:

python ./client.py

Here's the testing result:

Upload files in Zotero in advance:

Zotero upload screenshot

Query document content via MCP:

Query document content screenshot

Metadata

Release files for iflow-mcp_lrriver-zotero_mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for iflow-mcp_lrriver-zotero_mcp 0.1.0
File Size Uploaded
iflow_mcp_lrriver_zotero_mcp-0.1.0.tar.gz 12.3 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for iflow-mcp_lrriver-zotero_mcp 0.1.0
File Interpreter ABI Platform
iflow_mcp_lrriver_zotero_mcp-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 31.8 kB

Release files / iflow_mcp_lrriver_zotero_mcp-0.1.0.tar.gz

Download URL iflow_mcp_lrriver_zotero_mcp-0.1.0.tar.gz
Size 12.3 kB
Tags Source
SHA-256 checksum
How to use checksums
48ddc6f7f3c3c516ce0628af4770f2d7e3b51ad40f4745d47a1089459cff3283
BLAKE2b-256 checksum
How to use checksums
171cc07c883008b3779873196cddecfd71c9f52fa431f4ea47bb443ec2972c70
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / iflow_mcp_lrriver_zotero_mcp-0.1.0-py3-none-any.whl

Download URL iflow_mcp_lrriver_zotero_mcp-0.1.0-py3-none-any.whl
Size 19.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4ff3c9c12f566a78cac313fd63d147fb01de6cc4f9cc0239dc83e2d84d0182ca
BLAKE2b-256 checksum
How to use checksums
f3ea07aed23a74957ef571c7947b69c5be5be680f499f0669f56318caa8885c3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.9.26 {"installer":{"name":"uv","version":"0.9.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page