by kujenga
Model Context Protocol (MCP) server for the Zotero API, in Python
# Add to your Claude Code skills
git clone https://github.com/kujenga/zotero-mcpThis project is a python server that implements the Model Context Protocol (MCP) for Zotero, giving you access to your Zotero library within AI assistants. It is intended to implement a small but maximally useful set of interactions with Zotero for use with MCP clients.
<a href="https://glama.ai/mcp/servers/jknz38ntu4"> <img width="380" height="200" src="https://glama.ai/mcp/servers/jknz38ntu4/badge" alt="Zotero Server MCP server" /> </a>This MCP server provides the following tools:
zotero_search_items: Search for items in your Zotero library using a text queryzotero_item_metadata: Get detailed metadata information about a specific Zotero itemzotero_item_fulltext: Get the full text of a specific Zotero item (i.e. PDF contents)These can be discovered and accessed through any MCP client or through the MCP Inspector.
Each tool returns formatted text containing relevant information from your Zotero items, and AI assistants such as Claude can use them sequentially, searching for items then retrieving their metadata or text content.
This server can either run against either a local API offered by the Zotero desktop application) or through the . The local API can be a bit more responsive, but requires that the Zotero app be running on the same computer with the API enabled. To enable the local API, do the following steps:
[!IMPORTANT] For access to the
/fulltextendpoint on the local API which allows retrieving the full content of items in your library, you'll need to install a Zotero Beta Build (as of 2025-03-30). Once 7.1 is released this will no longer be the case. See https://github.com/zotero/zotero/pull/5004 for more information. If you do not want to do this, use the Web API instead.
To use the Zotero Web API, you'll need to create an API key and find your Library ID (usually your User ID) in your Zotero account settings here: https://www.zotero.org/settings/keys
These are the available configuration options:
ZOTERO_LOCAL=true: Use the local Zotero API (default: false, see note below)ZOTERO_API_KEY: Your Zotero API key (not required for the local API)ZOTERO_LIBRARY_ID: Yo...