Zotero MCP

把你的 Zotero 文献库接入 Claude、ChatGPT、Cherry Studio、Cursor 等 AI 助手：搜索文献、读取元数据与 BibTeX、笔记、PDF 批注和全文，并可新建条目与笔记。

Connect your Zotero library to Claude, ChatGPT, Cherry Studio, Cursor and other MCP clients: search items, read metadata & BibTeX, notes, PDF annotations and full text, and create items and notes.

1创建 Zotero API key

Create a Zotero API key

登录 zotero.org，打开 https://www.zotero.org/settings/keys/new。
Sign in at zotero.org and open the “Create new private key” page.
Key Name 随便填，例如 MCP。
Give it any name, e.g. MCP.
在 Personal Library 下勾选：
Under Personal Library, tick:
Allow library access必选 required读取条目、附件信息、全文和批注 · read items, attachments, full text and annotations Allow notes access必选 required读取和新建笔记 · read and create notes Allow write access可选 optional让 AI 新建条目、加标签、放入分类；只想只读就不勾 · lets the AI create items, tag and file them; leave off for read-only
如果要访问群组文献库，在 Default Group Permissions 选 Read Only 或 Read/Write（可选）。
For group libraries (optional), set Default Group Permissions to Read Only or Read/Write.
点 Save Key，复制页面上显示的 24 位 key（只显示这一次）。
Click Save Key and copy the 24-character key (it is shown only once).

关于 userID：不需要手动填写，下一步会根据 key 自动查询。想自己核对的话，它就在 settings/keys 页面上方 “Your userID for use in API calls is …”。
Your numeric userID is looked up automatically from the key. It is also shown at the top of settings/keys (“Your userID for use in API calls is …”).

2生成你的专属 MCP 地址

Generate your personal MCP URL

粘贴 Zotero API key · Paste your Zotero API key

显示 key · show key

这个地址就是你的密码，请勿公开分享。· This URL works like a password. Do not share it.

3连接到你的 AI 客户端

Connect your client. Snippets below fill in your URL automatically after step 2.

Claude 网页版 / Claude.ai · ChatGPT（自定义连接器 custom connector）

Claude.ai：设置 → Connectors（连接器）→ Add custom connector，名称填 Zotero，URL 粘贴上面的地址，不填 OAuth。
Settings → Connectors → Add custom connector. Name: Zotero; URL: your personal URL; leave OAuth fields empty.

ChatGPT：设置 → Apps & Connectors → Advanced settings 打开 Developer mode → Create，填 URL，Authentication 选 No authentication。Deep Research 会用到 search/fetch 两个工具。
Settings → Apps & Connectors → Advanced settings → enable Developer mode → Create; paste the URL; Authentication: No authentication. Deep research uses the search/fetch tools.

Claude Desktop（通过 mcp-remote，需要 Node.js）

编辑 claude_desktop_config.json（设置 → Developer → Edit Config），然后重启 Claude Desktop。
Edit claude_desktop_config.json (Settings → Developer → Edit Config), then restart Claude Desktop. Requires Node.js.

Claude Code

Cherry Studio

设置 → MCP 服务器 → 添加服务器：类型选 可流式传输的 HTTP（streamableHttp），URL 填上面的地址。也可以用“从 JSON 导入”：
Settings → MCP Servers → Add: type Streamable HTTP (streamableHttp), URL = your URL. Or import JSON:

Cursor

写入 ~/.cursor/mcp.json（或项目里的 .cursor/mcp.json）：
Add to ~/.cursor/mcp.json (or the project .cursor/mcp.json):

其他客户端 / Other clients (Bearer header)

支持请求头的客户端，也可以用 /mcp 加 Bearer：把地址中 /u/ 和 /mcp 之间那段作为 token。
Clients that support headers can use /mcp with Authorization: Bearer <token>, where the token is the part between /u/ and /mcp.

!安全说明

Security notes

专属地址就是密码。拿到它的人可以按你给 key 的权限读写你的文献库。不要发到群里、截图或提交到公开代码库。
Your URL is a password. Anyone who has it can read (and, if allowed, write) your library. Do not post, screenshot or commit it.
服务器不保存你的 key。key 用 AES-GCM 加密后放进地址里，每次请求时在内存中解密并直接转发给 api.zotero.org，不写日志、不落盘。
Nothing is stored. Your key is AES-GCM-encrypted into the URL itself and decrypted in memory per request; it is never logged or saved.
如何撤销：到 zotero.org/settings/keys 删除这个 key，地址立即失效。想换地址，就新建一个 key 重新生成。
To revoke, delete the key at zotero.org/settings/keys; the URL stops working immediately. Create a new key to get a new URL.
只想让 AI 读不想让它改，就不要勾 Allow write access。
For read-only access, leave “Allow write access” unticked.
全文和批注来自 Zotero 云同步：PDF 需要在 Zotero 桌面端被索引并同步后才能读到全文。
Full text and annotations come from Zotero sync; PDFs must be indexed and synced by the Zotero desktop app.

可用工具 · Tools

zotero_search_items zotero_get_item_metadata zotero_get_item_children zotero_get_annotations zotero_get_item_fulltext zotero_list_collections zotero_get_collection_items zotero_list_tags zotero_get_recent zotero_list_libraries zotero_get_item_template zotero_create_item zotero_create_note zotero_update_tags zotero_add_to_collection zotero_create_collection search fetch