Zoteus MCP Server

by oscardvsio.github.oscardvs/zoteusv1.22.4

Zotero integration: hybrid search, PDF passages with page locators, CSL bibliographies, add by DOI, group libraries and writes including PDF annotations.

55Node.jsstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active8d ago

Install Zoteus MCP server

claude mcp add zoteus -e ZOTERO_API_KEY='<zotero-api-key>' -- npx -y @oscardvs/zoteus

{
  "mcpServers": {
    "zoteus": {
      "command": "npx",
      "args": [
        "-y",
        "@oscardvs/zoteus"
      ],
      "env": {
        "ZOTERO_API_KEY": "<zotero-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "zoteus": {
      "command": "npx",
      "args": [
        "-y",
        "@oscardvs/zoteus"
      ],
      "env": {
        "ZOTERO_API_KEY": "<zotero-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "zoteus": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@oscardvs/zoteus"
      ],
      "env": {
        "ZOTERO_API_KEY": "<zotero-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "zoteus": {
      "command": "npx",
      "args": [
        "-y",
        "@oscardvs/zoteus"
      ],
      "env": {
        "ZOTERO_API_KEY": "<zotero-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
ZOTERO_API_KEY	—	yes	Zotero API key (writes/sync/groups; optional for local-only reads).
ZOTEUS_LOCAL	—	—	Use the Zotero desktop local API: auto \| on \| off.
ZOTEUS_ALLOW_DELETE	—	—	Set to true to enable permanent deletion (off by default).

Remote endpoints

streamable-httphttps://mcp.zoteus.com/mcp

Freshness

Active — last maintenance signal 8d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-01 · 8d ago · GitHub
Latest release
2026-10-01 · 8d ago · GitHub · v1.22.4
Package published
no data · npm/PyPI
Registry entry updated
2026-10-01 · 8d ago · official registry · v1.22.4

FAQ

›How do I install the Zoteus MCP server in Claude Code?

Run: claude mcp add zoteus -e ZOTERO_API_KEY='<zotero-api-key>' -- npx -y @oscardvs/zoteus. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Zoteus require an API key?

Yes. It expects ZOTERO_API_KEY, of which 1 is a secret.

›Can I use Zoteus as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is Zoteus in the official MCP registry?

Yes, as io.github.oscardvs/zoteus.