Skip to content
MCP server

Zotero MCP

Search your Zotero library, retrieve item metadata, and read full text from AI assistants.

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.3.1
Listing updated
6 days ago

About Zotero MCP

Zotero MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add zotero-mcp --env ZOTERO_API_KEY='<ZOTERO_API_KEY>' -- uvx zotero-mcp

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

{
  "servers": {
    "zotero-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "zotero-mcp"
      ],
      "env": {
        "ZOTERO_API_KEY": "<ZOTERO_API_KEY>"
      }
    }
  }
}

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

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • ZOTERO_LOCALUse the local API from the Zotero desktop app instead of the Web API. Requires Zotero to be running with 'Allow other applications on this computer to communicate with Zotero' enabled under Settings > Advanced.
  • ZOTERO_API_KEYZotero Web API key from https://www.zotero.org/settings/keys. Not required when ZOTERO_LOCAL is true.
  • ZOTERO_LIBRARY_IDZotero library ID (your user ID for user libraries). Not required when ZOTERO_LOCAL is true.
  • ZOTERO_LIBRARY_TYPEWhether ZOTERO_LIBRARY_ID refers to a user or group library.

Pricing

Open source

Zotero MCP FAQ

Is Zotero MCP free?

Yes. Zotero MCP is open source, so you can use and self-host it for free.

How do I add Zotero MCP to Claude Code?

Run this command in your terminal: claude mcp add zotero-mcp --env ZOTERO_API_KEY='<ZOTERO_API_KEY>' -- uvx zotero-mcp

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers