Zotero MCP

Claude Code

1. Run this in a terminal, in your project folder:

claude mcp add --transport stdio zotero --env "ZOTERO_API_KEY=<YOUR_ZOTERO_API_KEY>" -- uvx --from zotero-mcp-server zotero-mcp serve

1. Start Claude Code and type /mcp. zotero should show as connected.

Add --scope user to make it available in every project. Replace the placeholders with your own values.

Claude Desktop

1. Open Settings → Developer → Edit Config. It opens claude_desktop_config.json. Add:

{
  "mcpServers": {
    "zotero": {
      "command": "uvx",
      "args": [
        "--from",
        "zotero-mcp-server",
        "zotero-mcp",
        "serve"
      ],
      "env": {
        "ZOTERO_API_KEY": "<YOUR_ZOTERO_API_KEY>"
      }
    }
  }
}

1. Save the file and restart Claude Desktop. Replace the placeholders with your own values.

Needs uv (Python) on your computer. The file lives in ~/Library/Application Support/Claude/ on macOS and %APPDATA%\Claude\ on Windows.

Cursor

Añadir a Cursor (se abre en una pestaña nueva)

Or add it by hand to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project):

{
  "mcpServers": {
    "zotero": {
      "command": "uvx",
      "args": [
        "--from",
        "zotero-mcp-server",
        "zotero-mcp",
        "serve"
      ],
      "env": {
        "ZOTERO_API_KEY": "<YOUR_ZOTERO_API_KEY>"
      }
    }
  }
}

Needs uv (Python) on your computer. Replace the placeholders with your own values.

VS Code

Add it to .vscode/mcp.json. VS Code asks for the secret the first time and stores it securely:

{
  "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
    }
  ]
}

Needs uv (Python) on your computer.

Devin Desktop

1. Add it to ~/.config/devin/mcp_config.json (macOS and Linux) or %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>"
      }
    }
  }
}

1. Refresh the MCP server list in Cascade. Replace the placeholders with your own values.

Devin Desktop is the new name for Windsurf.

Codex

codex mcp add zotero --env "ZOTERO_API_KEY=<YOUR_ZOTERO_API_KEY>" -- uvx --from zotero-mcp-server zotero-mcp serve

Or edit ~/.codex/config.toml directly:

[mcp_servers.zotero]
command = "uvx"
args = ["--from", "zotero-mcp-server", "zotero-mcp", "serve"]
env = { ZOTERO_API_KEY = "<YOUR_ZOTERO_API_KEY>" }

Needs uv (Python) on your computer. Replace the placeholders with your own values.

Gemini CLI

gemini mcp add -e "ZOTERO_API_KEY=<YOUR_ZOTERO_API_KEY>" zotero uvx -- --from zotero-mcp-server zotero-mcp serve

This adds it to the current project. Add -s user to use it everywhere.

Any client

Most clients that start local servers accept this shape:

{
  "mcpServers": {
    "zotero": {
      "command": "uvx",
      "args": [
        "--from",
        "zotero-mcp-server",
        "zotero-mcp",
        "serve"
      ],
      "env": {
        "ZOTERO_API_KEY": "<YOUR_ZOTERO_API_KEY>"
      }
    }
  }
}

Zed puts servers under context_servers in its settings, with the same command, args and env fields.

Needs uv (Python) on your computer. Replace the placeholders with your own values.

Insignia para README

[![Zotero MCP on mcp.tc](https://mcp.tc/i/zotero/badge.svg)](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.json

Qué significa cada campo