zotero-mcp MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

Se instala como un plugin de Zotero (.xpi), sin proceso de servidor separado
20 herramientas: búsqueda, búsqueda semántica, texto completo, anotaciones, notas, etiquetas
Lee texto completo de PDF en caché desde la base de datos de Zotero
100% local — los datos de tu biblioteca nunca salen de tu máquina

Demo en vivo

Cómo se ve en la práctica

zotero.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "zotero": {
      "command": "npx",
      "args": [
        "-y",
        "zotero-mcp"
      ],
      "_inferred": true
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "zotero": {
      "command": "npx",
      "args": [
        "-y",
        "zotero-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "zotero": {
      "command": "npx",
      "args": [
        "-y",
        "zotero-mcp"
      ],
      "_inferred": true
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "zotero": {
      "command": "npx",
      "args": [
        "-y",
        "zotero-mcp"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "zotero",
      "command": "npx",
      "args": [
        "-y",
        "zotero-mcp"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "zotero": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "zotero-mcp"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add zotero -- npx -y zotero-mcp

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: zotero-mcp

Cómo redactar una revisión de la literatura desde tu biblioteca de Zotero

👤 Investigadores, estudiantes de doctorado, analistas ⏱ ~45 min intermediate

Cuándo usarlo: Has recopilado 50+ artículos sobre un tema en Zotero y necesitas sintetizarlos en una revisión coherente.

Requisitos previos

Zotero de escritorio con plugin zotero-mcp instalado — Descarga .xpi desde releases, Herramientas → Complementos → Instalar desde archivo
PDFs adjuntos e indexados — Haz clic derecho en colección → Reconstruir índice de texto completo si la búsqueda está vacía

Flujo

Define el alcance de la revisión

Busca semánticamente en mi colección de Zotero 'Agentic AI' artículos sobre estrategias de selección de herramientas. Devuelve los 15 principales.✓ Copiado

→ Lista clasificada con títulos, autores, año, fragmento de resumen
Extrae afirmaciones clave por artículo

Para cada uno de esos 15, lee el texto completo y extrae (a) la afirmación principal, (b) el método, (c) el conjunto de datos o configuración.✓ Copiado

→ Tabla estructurada que puedas ordenar
Sintetiza con citas

Escribe una revisión de 3 páginas agrupando estos por enfoque. Cita cada afirmación con claves de elementos de Zotero en estilo (Autor, Año).✓ Copiado

→ Borrador con citas entre corchetes que se asignan nuevamente a tu biblioteca

Resultado: Una revisión de primer borrador fundamentada en artículos que realmente posees, cada afirmación rastreable hasta un elemento de Zotero.

Errores comunes

La búsqueda de texto completo no devuelve nada — Zotero solo indexa PDFs con capa de texto. Primero ejecuta OCR en PDFs de imagen
Citas alucinadas — Solicita la clave del elemento de Zotero (p. ej. ABCD1234) junto con cada cita — puedes pegarla en un verificador

Combinar con: arxiv

Resume tus resaltados en una colección de Zotero

👤 Lectores ávidos, trabajadores del conocimiento ⏱ ~20 min beginner

Cuándo usarlo: Has resaltado cosas en 30 libros/artículos y quieres un resumen temático.

Flujo

Extrae anotaciones por color/etiqueta

Busca mis resaltados amarillos en la colección 'Product Strategy'. Devuelve el texto resaltado más el elemento principal.✓ Copiado

→ Lista de resaltados agrupados por fuente
Agrupa en temas

Agrupa los resaltados en 5-7 temas. Para cada tema, proporciona una síntesis de 2 oraciones con los elementos de fuente.✓ Copiado

→ Notas temáticas con citas

Resultado: Resaltados dispersos convertidos en una nota de base de conocimiento personal.

Combinar con: anytype

Etiqueta automáticamente y anota artículos recién agregados de Zotero

👤 Mantenedores de bibliotecas ⏱ ~15 min intermediate

Cuándo usarlo: Sueltas artículos en una colección 'Sin ordenar' y quieres que se clasifiquen semanalmente.

Flujo

Lista elementos agregados esta semana en 'Sin ordenar'

Lista elementos de Zotero agregados en los últimos 7 días a mi colección 'Sin ordenar'.✓ Copiado

→ Bandeja de entrada de elementos nuevos
Genera etiquetas y un resumen de 1 línea por elemento

Para cada uno, propone 3-5 etiquetas y un resumen de 1 línea basado en el resumen. Aplícalas mediante las herramientas de escritura.✓ Copiado

→ Elementos ahora etiquetados; resumen guardado como adjunto de nota

Resultado: Una biblioteca de Zotero que se mantiene automáticamente con etiquetado consistente.

Errores comunes

Las herramientas de escritura modifican tu biblioteca irreversiblemente — sin deshacer — Primero ejecuta contra una colección de prueba, o haz una copia de seguridad de zotero.sqlite antes de habilitar escrituras

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

zotero + arxiv

Exploración primero en Arxiv y luego guardado automático en Zotero para lectura

Encuentra 10 artículos recientes de arxiv sobre agentes aumentados por recuperación, luego agrega los que aún no tienes a tu colección 'Agents' de Zotero.✓ Copiado

zotero + anytype

Las notas de literatura viven en Anytype; los PDFs de fuente permanecen en Zotero

Para los 10 artículos principales en mi colección 'Agents', crea una página de Anytype por artículo con el resumen y un enlace invertido a la clave del elemento de Zotero.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
search_library	query: str, filters?: { collection, tag, itemType }	Búsqueda de texto/metadatos en tu biblioteca	0 — BD local
search_fulltext	query: str	Busca dentro de cuerpos de PDF (solo capas de texto indexadas)	0
semantic_search	query: str, top_k?: int	Coincidencia a nivel de concepto en lugar de palabra clave	0 — incrustaciones locales
search_annotations	color?, tag?, query?	Extrae tus resaltados/notas	0
get_item_details	item_key: str	Expande una referencia de un resultado de búsqueda	0
get_content	item_key or attachment_key	Proporciona el artículo completo a Claude	0

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Ninguno — completamente local
Tokens por llamada: Las descargas completas de PDF pueden alcanzar 30k+ tokens; divide en fragmentos antes de proporcionar
Monetario: Gratuito (Zotero es gratuito; el plugin es MIT)
Consejo: Prefiere search_fulltext devolviendo fragmentos sobre get_content devolviendo el PDF completo

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Ninguno — el plugin se ejecuta dentro de Zotero; HTTP local en 127.0.0.1:23120

Salida de datos: Ninguno en modo de lectura; las escrituras modifican zotero.sqlite localmente

Resolución de problemas

Errores comunes y soluciones

El cliente MCP no puede conectar en el puerto 23120

Abre Zotero → Preferencias → Plugin Zotero MCP → verifica que 'Habilitar servidor' esté marcado y el puerto no esté bloqueado

Verificar: curl http://127.0.0.1:23120/health

La búsqueda de texto completo devuelve vacío

El PDF no tiene capa de texto. Haz clic derecho en elemento → Reindexar elemento, o ejecuta OCR a través del OCR integrado de Zotero

Operaciones de escritura prohibidas

Habilita modo de escritura en preferencias del plugin — desactivado por defecto por seguridad

Alternativas

zotero-mcp vs otros

Alternativa	Cuándo usarla	Contrapartida
API web oficial de Zotero	Necesitas acceso de sincronización en la nube desde un servidor remoto	Requiere clave de API; limitado por tasa; sin búsqueda semántica
Readwise MCP	Tus resaltados viven en Readwise, no en Zotero	Basado en la nube, se requiere suscripción

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills