zotero-mcp

zotero-mcp

Servidor MCP de lectura y escritura para Zotero. Un servidor MCP con soporte completo de escritura para gestionar la biblioteca de Zotero desde asistentes de IA.

Permite crear elementos, gestionar colecciones, encontrar y fusionar duplicados, e importar BibTeX desde Claude Code/Desktop, o cualquier cliente compatible con MCP.

Utiliza la API web de Zotero (requiere clave de API). Obtén la clave en https://www.zotero.org/settings/keys.

Características

Búsqueda y lectura

Herramienta	Descripción
search_items	Búsqueda de texto completo con filtros de colección, tipo y etiquetas
get_item	Metadatos detallados o exportación BibTeX para un solo elemento
get_collections	Lista todas las colecciones con jerarquía y recuentos de elementos
get_collection_items	Lista los elementos de una colección específica
find_duplicates	Encuentra duplicados por título/DOI, o escanea toda la biblioteca
get_tags	Lista todas las etiquetas con recuentos de elementos

Escritura

Herramienta	Descripción
create_item	Crear elemento a partir de datos de campos
create_item_from_doi	Crear elemento por DOI (autocompleta metadatos mediante el traductor de Zotero + CrossRef)
import_bibtex	Importar entradas BibTeX en una colección
update_item	Actualizar campos de elemento con protección de conflictos de versión

Colecciones

Herramienta	Descripción
create_collection	Crear una colección (con padre opcional)
add_to_collections	Añadir un elemento a varias colecciones a la vez
remove_from_collection	Eliminar elemento de la colección (no lo borra)

Gestión

Herramienta	Descripción
merge_duplicates	Fusionar duplicados: transferir metadatos, etiquetas, colecciones al conservador, eliminar el resto
delete_item	Eliminar un elemento

Instalación

Requiere Python 3.11+ y uv.

# Clone the repo
git clone https://github.com/BirdInTheTree/zotero-mcp.git
cd zotero-mcp
uv sync

Uso

Claude Code

claude mcp add zotero \
  -e ZOTERO_API_KEY=your-key \
  -e ZOTERO_USER_ID=your-user-id \
  -- uv run --directory /path/to/zotero-mcp python -m zotero_mcp

Claude Desktop

Añade a tu configuración de Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json en macOS):

{
  "mcpServers": {
    "zotero": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/zotero-mcp", "python", "-m", "zotero_mcp"],
      "env": {
        "ZOTERO_API_KEY": "your-key",
        "ZOTERO_USER_ID": "your-user-id"
      }
    }
  }
}

Configuración

Variable	Requerida	Descripción
ZOTERO_API_KEY	sí	Clave de API web de Zotero
ZOTERO_USER_ID	sí	Tu ID de usuario de Zotero

Obtén tu clave de API en https://www.zotero.org/settings/keys. Tu ID de usuario se muestra en la misma página.

Ejemplos

Una vez conectado, puedes pedirle a tu asistente de IA cosas como:

• "Busca en mi Zotero artículos ..."
• "Crea una nueva colección llamada ..."
• "Importa este BibTeX en mi colección"
• "Encuentra elementos duplicados en mi biblioteca y fúndelos"
• "Añade este artículo a ambas colecciones"
• "Busca el DOI 10.1234/example y añádelo a mi biblioteca"

Desarrollo

# Install with dev dependencies
uv sync --dev

# Run tests
uv run pytest tests/ -v

Licencia

MIT