Zotero MCP
Servidor MCP de 54yyyu (Steven Yu)
Busca, lee, anota y añade artículos en tu biblioteca de investigación de Zotero, con la aplicación local o la API web.
Instalar Zotero MCP
Se ejecuta en tu equipo. Tu cliente lo inicia con este comando:
Requiere uv (Python) en tu equipo. Los pasos de configuración de abajo muestran dónde va el comando en cada cliente.
ZOTERO_LOCALopcional Read from the local Zotero desktop app instead of the web API. Requires Zotero 7+ with the local API enabled in Settings > Advanced.ZOTERO_API_KEYsecreto opcional Zotero Web API key from https://www.zotero.org/settings/keys. Only needed when ZOTERO_LOCAL is false, or for write operations in hybrid…ZOTERO_LIBRARY_IDopcional Zotero user or group library ID. Only needed when ZOTERO_LOCAL is false, or for write operations in hybrid mode.ZOTERO_LIBRARY_TYPEopcional Whether ZOTERO_LIBRARY_ID refers to a personal or a group library.ZOTERO_MCP_TOOLSETSopcional Which optional tool groups to expose, as a comma-separated list. Every tool is sent to the model on each request, so optional capabilities…
Compartir este servidor
El enlace abre esta página, con el comando de instalación y los pasos de configuración.
mcp.tc/i/zoteroDescripción
Conecta un asistente de IA con una biblioteca de investigación de Zotero. Puedes buscar por título, autor, etiqueta, colección, texto completo o significado (búsqueda semántica), leer metadatos, BibTeX y texto de PDF, colocar resaltados y notas en PDF, y añadir artículos por DOI, URL, ISBN, BibTeX o archivo. Se pueden gestionar colecciones, etiquetas y duplicados, y hay disponibles recuentos opcionales de citas de Scite.
Se ejecuta en local mediante stdio como el paquete de Python zotero-mcp-server (uvx o pip, Python 3.10+). El modo local lee de la aplicación de escritorio Zotero 7+ con su API local habilitada y no necesita clave. El modo web o híbrido necesita ZOTERO_API_KEY y ZOTERO_LIBRARY_ID. Los grupos de herramientas opcionales se eligen con ZOTERO_MCP_TOOLSETS.
Qué puedes hacer
- Buscar en la biblioteca por título, autor, etiqueta, colección, texto completo o significado
- Leer metadatos de elementos, BibTeX, texto completo y rangos de páginas de PDF
- Crear resaltados, cuadros de área y notas en PDF
- Añadir artículos por DOI, URL, ISBN, BibTeX o archivo
- Gestionar colecciones y etiquetas y fusionar duplicados
- Consultar recuentos de citas y alertas de retractación con Scite (opcional)
Herramientas
Los servidores locales muestran sus herramientas cuando están en marcha, así que no podemos mostrarlas aquí. Busca la lista en su documentación; tu cliente las muestra después de añadirlo.
Prompts de ejemplo
Encuentra artículos en mi biblioteca sobre mecanismos de atención
Resume los hallazgos clave de este artículo
Resalta las afirmaciones principales de este PDF
Añade a mi biblioteca de Zotero el artículo con DOI 10.1000/xyz123
Configuración
Todos los clientes inician Zotero MCP en tu equipo con el mismo comando. Elige el tuyo; la página recuerda tu elección.
Claude Code
- Ejecútalo en un terminal, en la carpeta de tu proyecto:
claude mcp add --transport stdio zotero --env "ZOTERO_API_KEY=<YOUR_ZOTERO_API_KEY>" -- uvx --from zotero-mcp-server zotero-mcp serve- Inicia Claude Code y escribe
/mcp. zotero debería aparecer como conectado.
Añade --scope user para que esté disponible en todos los proyectos. Sustituye los marcadores por tus propios valores.
Claude Desktop
- Abre Settings → Developer → Edit Config. Se abre
claude_desktop_config.json. Añade:
{
"mcpServers": {
"zotero": {
"command": "uvx",
"args": [
"--from",
"zotero-mcp-server",
"zotero-mcp",
"serve"
],
"env": {
"ZOTERO_API_KEY": "<YOUR_ZOTERO_API_KEY>"
}
}
}
}- Guarda el archivo y reinicia Claude Desktop. Sustituye los marcadores por tus propios valores.
Necesita uv (Python) en tu equipo. El archivo está en ~/Library/Application Support/Claude/ en macOS y en %APPDATA%\Claude\ en Windows.
Cursor
Añadir a Cursor (se abre en una pestaña nueva)
O añádelo a mano en ~/.cursor/mcp.json (todos los proyectos) o en .cursor/mcp.json (este proyecto):
{
"mcpServers": {
"zotero": {
"command": "uvx",
"args": [
"--from",
"zotero-mcp-server",
"zotero-mcp",
"serve"
],
"env": {
"ZOTERO_API_KEY": "<YOUR_ZOTERO_API_KEY>"
}
}
}
}Necesita uv (Python) en tu equipo. Sustituye los marcadores por tus propios valores.
VS Code
Añádelo a .vscode/mcp.json. VS Code pide el secreto la primera vez y lo guarda de forma segura:
{
"servers": {
"zotero": {
"type": "stdio",
"command": "uvx",
"args": [
"--from",
"zotero-mcp-server",
"zotero-mcp",
"serve"
],
"env": {
"ZOTERO_API_KEY": "${input:zotero-api-key}"
}
}
},
"inputs": [
{
"type": "promptString",
"id": "zotero-api-key",
"description": "ZOTERO_API_KEY",
"password": true
}
]
}Necesita uv (Python) en tu equipo.
Devin Desktop
- Añádelo a
~/.config/devin/mcp_config.json(macOS y Linux) o a%APPDATA%\devin\mcp_config.json(Windows):
{
"mcpServers": {
"zotero": {
"command": "uvx",
"args": [
"--from",
"zotero-mcp-server",
"zotero-mcp",
"serve"
],
"env": {
"ZOTERO_API_KEY": "<YOUR_ZOTERO_API_KEY>"
}
}
}
}- Actualiza la lista de servidores MCP en Cascade. Sustituye los marcadores por tus propios valores.
Devin Desktop es el nuevo nombre de Windsurf.
Codex
codex mcp add zotero --env "ZOTERO_API_KEY=<YOUR_ZOTERO_API_KEY>" -- uvx --from zotero-mcp-server zotero-mcp serveO edita directamente ~/.codex/config.toml:
[mcp_servers.zotero]
command = "uvx"
args = ["--from", "zotero-mcp-server", "zotero-mcp", "serve"]
env = { ZOTERO_API_KEY = "<YOUR_ZOTERO_API_KEY>" }Necesita uv (Python) en tu equipo. Sustituye los marcadores por tus propios valores.
Gemini CLI
gemini mcp add -e "ZOTERO_API_KEY=<YOUR_ZOTERO_API_KEY>" zotero uvx -- --from zotero-mcp-server zotero-mcp serveAsí lo añades al proyecto actual. Añade -s user para usarlo en todas partes.
Cualquier cliente
La mayoría de los clientes que inician servidores locales aceptan esta forma:
{
"mcpServers": {
"zotero": {
"command": "uvx",
"args": [
"--from",
"zotero-mcp-server",
"zotero-mcp",
"serve"
],
"env": {
"ZOTERO_API_KEY": "<YOUR_ZOTERO_API_KEY>"
}
}
}
}Zed pone los servidores bajo context_servers en sus ajustes, con los mismos campos command, args y env.
Necesita uv (Python) en tu equipo. Sustituye los marcadores por tus propios valores.
Insertar
Muestra Zotero MCP en un README o en tu web. Cada inserción enlaza a esta página, usa el comando de instalación del servidor y no instala cookies. Cómo funcionan las inserciones
La tarjeta, el iframe y el JSON están en inglés. Añade ?lang=it, fr, de o es a su dirección para otro idioma.
Insignia para README
[](https://mcp.tc/i/zotero)<a href="https://mcp.tc/i/zotero"><img src="https://mcp.tc/i/zotero/badge.svg" alt="Zotero MCP on mcp.tc" height="20"></a>Sigue el modo claro u oscuro de quien lee. Añade ?theme=light o ?theme=dark para fijarlo, o ?style=compact para mostrar el símbolo sin la palabra.
Tarjeta para web
<script src="https://mcp.tc/w/zotero.js" async></script>La tarjeta aparece donde esté la etiqueta. Añade data-theme="dark" o data-size="compact" a la etiqueta para cambiarla. El archivo contiene todo lo que necesita, así que no hace otras solicitudes ni instala cookies.
iframe
<iframe src="https://mcp.tc/embed/zotero" title="Zotero MCP on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>Úsalo en páginas que no permiten scripts. Añade ?theme=light o ?theme=dark a la dirección para fijar los colores.
JSON
La ficha como datos para tus propias páginas y herramientas: nombre, descripción corta, comando de instalación, herramientas y los enlaces «Add to». Cualquier web puede leerla (CORS abierto).
https://mcp.tc/i/zotero.jsonPrompt para la IA
Pégalo en un asistente de programación con IA, como Claude Code o Cursor, y añadirá la tarjeta de Zotero MCP a tu web.
Añade a mi web la tarjeta de mcp.tc de Zotero MCP, un servidor MCP. Es un solo script estático: sin paso de build, sin paquetes que instalar, sin cookies.
Pon esta etiqueta donde deba aparecer la tarjeta. La tarjeta se muestra justo antes de ella:
```html
<script src="https://mcp.tc/w/zotero.js" async></script>
```
Para mostrarla en otro sitio, pon allí este marcador y carga el mismo script una sola vez, por ejemplo antes de `</body>`. Deja el enlace dentro: lo ven los visitantes sin JavaScript.
```html
<div data-mcptc="zotero"><a href="https://mcp.tc/i/zotero">Zotero MCP on mcp.tc</a></div>
```
Opciones:
- `data-theme="light"` o `"dark"` en la etiqueta o el marcador fija los colores. Sin él, la tarjeta sigue el modo claro u oscuro del visitante.
- `data-size="compact"` da una tarjeta más pequeña, sin el eslogan.
- La variable CSS `--mcptc-max-width` en el marcador o en un elemento padre fija el ancho (por defecto `520px`).
- `?lang=` en la URL del script fija el idioma de la tarjeta: `en`, `it`, `fr`, `de` o `es`.
Si el sitio tiene una Content Security Policy, permite `script-src https://mcp.tc` e `img-src data:` (el icono va incrustado).
Para un README u otra documentación en Markdown, usa la insignia:
```markdown
[](https://mcp.tc/i/zotero)
```
Referencia: https://mcp.tc/es/embedHistorial de cambios
Este servidor se ejecuta en tu ordenador, así que seguimos su paquete de PyPI: cada versión nueva aparece aquí, junto con las ediciones de su responsable.
-
Nueva versión 0.17.2 (antes 0.17.1). Leída en PyPI.
-
Nueva versión 0.17.1 (antes 0.17.0). Leída en PyPI.
-
Nueva versión 0.16.0 (antes 0.15.2). Leída en PyPI.
-
Nueva versión 0.15.2 (antes 0.15.1). Leída en PyPI.
-
Nueva versión 0.15.1 (antes 0.15.0). Leída en PyPI.
-
Nueva versión 0.15.0 (antes 0.14.1). Leída en PyPI.
-
Nueva versión 0.14.1 (antes 0.14.0). Leída en PyPI.
-
Nueva versión 0.13.3 (antes 0.13.2). Leída en PyPI.
-
Inicio del seguimiento: versión 0.13.2.
Preguntas frecuentes
¿Puedo pegar mcp.tc/i/zotero en mi cliente MCP?
No. Zotero MCP se ejecuta en tu propio equipo, iniciado por tu cliente, así que no tiene una dirección web a la que conectarse. El enlace rápido es la página para compartir; el comando de instalación es uvx --from zotero-mcp-server zotero-mcp serve.
¿Zotero MCP necesita una clave de API?
Sí. Lee ZOTERO_API_KEY de su entorno, y ZOTERO_API_KEY es un secreto. Pon el valor en la configuración de tu cliente en tu propio equipo, nunca en un archivo compartido.
¿Zotero MCP es un servidor remoto o local?
Local. Tu cliente lo inicia como un proceso en tu equipo con uvx --from zotero-mcp-server zotero-mcp serve, que necesita uv (Python).
¿Qué puede hacer Zotero MCP?
Puedes buscar en la biblioteca por título, autor, etiqueta, colección, texto completo o significado, leer metadatos de elementos, BibTeX, texto completo y rangos de páginas de PDF y crear resaltados, cuadros de área y notas en PDF.
¿Qué clientes pueden usarlo?
Cualquier cliente que inicie servidores locales: Claude Code, Claude Desktop, Cursor, VS Code, Devin Desktop, Codex, Gemini CLI, Zed y otros. claude.ai y ChatGPT solo se conectan a servidores remotos.
¿mcp.tc sigue los cambios de Zotero MCP?
En parte. Se ejecuta en tu ordenador, así que seguimos su paquete de PyPI: su pestaña Historial muestra cada versión nueva y las ediciones de su responsable. Sigue la ficha para recibir un correo cuando cambie.
¿Quién escribió esta página?
El robot de mcp.tc leyó los metadatos públicos de Zotero MCP (las páginas de su paquete y de su repositorio), y un modelo de IA redactó el texto a partir de ellos. Una persona revisa todo lo que las comprobaciones no pueden confirmar. Aun así, el texto puede contener errores, así que si encuentras uno, usa Reportar esta ficha en esta página. Esta traducción la hizo un modelo de IA a partir del texto en inglés.
mcp.tc no tiene relación con 54yyyu (Steven Yu). Esta página se creó a partir de los metadatos públicos de Zotero MCP, comprobados por última vez el 3 oct 2026, y un modelo de IA escribió la descripción, así que puede contener errores. Los nombres y marcas pertenecen a sus titulares. ¿Algo no cuadra? Reportar esta ficha. La traducción la hizo un modelo de IA a partir del texto en inglés.