zotero-mcp-ubuntu

jwingnut/zotero-mcp-ubuntu

3.2

If you are the rightful owner of zotero-mcp-ubuntu and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The Zotero MCP Server is a FastMCP server designed to facilitate interaction between Claude Code and Zotero through a bridge server on Windows.

Tools
9
Resources
0
Prompts
0

Zotero MCP Server (Ubuntu)

FastMCP server that provides Claude Code with tools to interact with Zotero via a bridge server running on Windows.

Architecture

Claude Code (Ubuntu VM)
    │
    └── Zotero MCP Server (this)
            │
            │ HTTP requests
            ▼
        Windows Host (192.168.56.1:5555)
            │
            ├── Zotero Bridge Server (Flask)
            │       │
            │       ▼
            └── Zotero + Better BibTeX

Setup

  1. Create virtual environment:
uv venv
source .venv/bin/activate
uv pip install fastmcp httpx
  1. Discover Windows host IP:
python discover_host.py
  1. Configure Claude Code (add to .mcp.json):
{
  "mcpServers": {
    "zotero": {
      "command": "/home/vboxuser/projects/zotero-mcp/run_zotero_mcp.sh",
      "args": []
    }
  }
}

Tools Provided

ToolDescription
check_zotero_connectionVerify bridge connectivity
search_zoteroSearch library, returns scannable cites
get_scannable_citeGet ODF scannable cite for a citekey
get_scannable_cites_batchGet multiple scannable cites
get_item_metadataFull CSL-JSON metadata
get_abstractQuick title + abstract lookup
list_collectionsList Zotero collections
get_collection_itemsGet items in a collection
generate_bibliographyGenerate formatted bibliography

Scannable Cite Format

Output format matches Zotero ODF Scan plugin:

{  | (Author et al., Year) |  |  |zu:LIBID:ITEMKEY}

Files

  • zotero_mcp.py - MCP server
  • discover_host.py - Network discovery script
  • run_zotero_mcp.sh - Wrapper script for Claude Code
  • start_zotero_mcp.sh - Manual startup script