Zotero Comfort

High-level Zotero MCP integration with smart research workflows.

Overview

Zotero Comfort provides two layers of functionality:

A) Proxy Layer - Direct re-exposure of 54yyyu/zotero-mcp tools with a clean Python API.

B) Smart Workflows - High-level orchestrations for common research tasks.

Installation

pip install zotero-comfort

Or with Docker:

docker build -t zotero-comfort .
docker run -e ZOTERO_API_KEY=xxx -e ZOTERO_LIBRARY_ID=123 zotero-comfort

Configuration

Set environment variables:

export ZOTERO_API_KEY="your-api-key"
export ZOTERO_LIBRARY_ID="your-library-id"
export ZOTERO_LIBRARY_TYPE="group"  # or "user"

Usage

As Python Library

from zotero_comfort import ZoteroProxy, ZoteroWorkflows

# Proxy layer - direct tool access
proxy = ZoteroProxy()
papers = proxy.search_papers("FHIR interoperability", limit=20)
metadata = proxy.get_metadata("ABC12345")

# Smart workflows - high-level operations
workflows = ZoteroWorkflows()
reading_list = workflows.build_reading_list("clinical NLP", max_papers=15)
result = workflows.smart_add_paper("10.1234/example.2024")
bibtex = workflows.export_bibliography(collection_name="FHIR")

As MCP Server

Add to your Claude configuration:

{
  "mcpServers": {
    "zotero-comfort": {
      "command": "zotero-comfort",
      "env": {
        "ZOTERO_API_KEY": "your-key",
        "ZOTERO_LIBRARY_ID": "your-library-id"
      }
    }
  }
}

Available Tools

Proxy Layer (A)

Tool	Description
zotero_search	Search papers by keyword
zotero_get_metadata	Get paper details
zotero_list_collections	List all collections
zotero_get_collection_items	Get items in collection
zotero_get_fulltext	Get paper full text
zotero_semantic_search	AI-powered semantic search

Smart Workflows (B)

Tool	Description
build_reading_list	Create curated topic reading list
smart_add_paper	Add paper with duplicate check
export_bibliography	Export as BibTeX
find_related_papers	Find semantically similar papers

Development

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Lint
ruff check src/

License

MIT