Zotero MCP

Zotero MCP: Chatea con tu biblioteca de investigación—local o web—en Claude, ChatGPT y más.

Zotero MCP conecta tu biblioteca de investigación de Zotero con ChatGPT, Claude y otros asistentes de IA (p. ej., Cherry Studio, Chorus, Cursor) mediante el Protocolo de Contexto de Modelo. Busca en tu biblioteca, lee y anota artículos, añade y organiza elementos, y encuentra investigaciones por significado.

Agentes de IA: lee primero docs/for-agents.md. Cubre qué ruta usar, la configuración y los comandos en un solo lugar.

✨ Qué hace

• 🔍 Busca por título, autor, etiqueta, colección, texto completo o significado (búsqueda semántica con incrustaciones locales, de OpenAI, Gemini u Ollama)
• 📚 Lee metadatos, BibTeX, texto completo y rangos de páginas de PDFs, con imágenes de página donde la extracción de texto distorsiona matemáticas, figuras y tablas
• 📝 Anota: resaltados y áreas de recuadro colocados en las palabras, figuras, tablas o ecuaciones exactas; notas; extracción de anotaciones de PDF
• ✏️ Escribe: añade artículos por DOI, URL, ISBN, BibTeX o archivo (con PDFs de acceso abierto), gestiona colecciones y etiquetas, fusiona duplicados
• 💻 Local o web: en modo local, las lecturas provienen directamente de zotero.sqlite; las escrituras van al Zotero 10+ en ejecución o a través de la API web
• 🪶 Dos formas de acceso: un servidor MCP para aplicaciones de chat, o zotero-cli más una habilidad de agente para agentes de codificación
• 📊 Scite recuentos de citas y alertas de retractación (opcional)

🚀 Inicio rápido

1. Instala (Python 3.10+):

uv tool install zotero-mcp-server     # or: pip install zotero-mcp-server

¿Nuevo en la línea de comandos? Prueba el Zotero MCP Setup creado por la comunidad: un instalador GUI para macOS, scripts de un clic para Mac y Windows, y una guía paso a paso.

2. Habilita la API local de Zotero: en Zotero 7+, abre Configuración → Avanzado y marca Permitir que otras aplicaciones en este ordenador se comuniquen con Zotero.

3. Conecta tu asistente:

zotero-mcp setup      # auto-configures Claude Desktop

o añade el servidor manualmente (Claude Desktop: claude_desktop_config.json; Claude Code: ~/.claude.json):

{
  "mcpServers": {
    "zotero": {
      "command": "zotero-mcp",
      "env": { "ZOTERO_LOCAL": "true" }
    }
  }
}

4. Escrituras (opcional): en Zotero 10+, ejecuta zotero-mcp authorize-local una vez y elige Permitir siempre. En Zotero más antiguo, añade ZOTERO_API_KEY y ZOTERO_LIBRARY_ID para escribir a través de la API web.

Luego pregunta cosas como "Encuentra artículos en mi biblioteca sobre mecanismos de atención", "Resume los hallazgos clave de este artículo" o "Resalta las afirmaciones principales de este PDF".

ChatGPT, Cherry Studio, Chorus, Autohand y otros clientes: consulta Cómo empezar.

Extras opcionales

La instalación base cubre búsqueda, lectura, anotaciones y escrituras. Las funciones más pesadas son extras:

Extra	Qué añade	Comando de instalación
semantic	Búsqueda semántica mediante ChromaDB, sentence-transformers, incrustaciones de OpenAI/Gemini	pip install "zotero-mcp-server[semantic]"
pdf	Esquemas de PDF, diseño de página e imágenes de página (PyMuPDF), anotaciones de EPUB	pip install "zotero-mcp-server[pdf]"
scite	Scite recuentos de citas y alertas de retractación (no se necesita cuenta)	pip install "zotero-mcp-server[scite]"
all	Todo lo anterior	pip install "zotero-mcp-server[all]"

Actualiza en cualquier momento con zotero-mcp update.

🪶 ¿Servidor MCP o habilidad de agente?

Si tu agente tiene un shell (Claude Code, Cursor, Codex, Windsurf, Gemini CLI, Amp, OpenCode …), un comando le enseña a manejar zotero-cli:

zotero-mcp install-skill

Un servidor MCP envía el esquema de cada herramienta en cada solicitud, antes de que escribas nada. La habilidad cuesta 98 tokens hasta que el agente decide que es relevante:

Ruta	En contexto	Pagado
Servidor MCP, perfil predeterminado (38 herramientas)	13,448	cada solicitud
Habilidad de agente, solo frontmatter	98	siempre
Habilidad de agente, cuerpo cargado	1,368	cuando se activa

Usa el servidor MCP cuando tu cliente hable MCP pero no tenga shell (Claude Desktop, ChatGPT); usa la habilidad cuando tenga shell. Ambos comparten una configuración. Detalles: CLI y habilidad de agente.

📖 Documentación

Guía	Qué contiene
Cómo empezar	Conexión de Claude Desktop y Claude Code, ChatGPT, Cherry Studio, Chorus, Autohand y otros clientes MCP
Configuración	Variables de entorno, escrituras locales, modos web e híbrido, backend de lectura SQLite, búsqueda global, extracción de texto, opciones de línea de comandos
Búsqueda semántica	Modelos de incrustación, construcción y actualización del índice
Herramientas	Cada herramienta MCP, grupos de herramientas (ZOTERO_MCP_TOOLSETS), elementos relacionados, extracción de anotaciones de PDF
CLI y habilidad de agente	Referencia de comandos zotero-cli, salida de --json, install-skill
Docker	Imágenes de contenedor y modos de ejecución
Solución de problemas	Problemas comunes y soluciones
Para agentes de IA	Una guía para un agente que configura o usa Zotero MCP

Sitio web: stevenyuyy.com/zotero-mcp · Registro de cambios

🤝 Contribuciones

Las incidencias y solicitudes de extracción son bienvenidas. Ejecuta las pruebas con uv run pytest tests/. Un plan de pruebas de integración en vivo, pensado para que Claude lo ejecute contra una biblioteca real, está en docs/integration-test-plan.md.

☕ Apoyo

Zotero MCP es gratuito y tiene licencia MIT.

Si te ahorra tiempo a ti o a tu laboratorio, patrocinar ayuda a cubrir las partes menos glamurosas: casos límite de Windows y WSL2, cambios de esquema de Zotero, soporte para bibliotecas de grupo y la infraestructura de incrustación/búsqueda.

Laboratorios e instituciones: los niveles de $50 y $200 están pensados para ser reembolsables e incluyen prioridad en el triaje de las incidencias que afectan tu flujo de trabajo.

Contribuyentes

Gracias a todos los que han contribuido con código, correcciones e ideas a Zotero MCP.

📄 Licencia

MIT