mcp-zotero

kaliaboi/mcp-zotero

🔗 Latest commit:d219288

🕒 Updated:Sep 9, 2025, 01:06 PM

TypeScript

AI Tools

A connector for Claude Desktop to work with collection and sources on your Zotero Cloud.

MCP Trust Score

Based on our comprehensive evaluation criteria

🤖 Evaluated by gemini-2.5-flashFix

Trust Score48/100

• Basic MCP protocol features implemented (12/40)
• GitHub community is not mature yet (10/20)
• Optimal dependency management (20/20)
• Room for improvement in deployment maturity
• Documentation (8/8)
• Archestra MCP Trust score badge is missing

GitHub Metrics

Repository statistics and activity

⭐ GitHub Stars:127

👥 Contributors:3

📋 Total Issues:10

📦 Has Releases:No

🔧 Has CI/CD Pipeline:No

Configuration

Configuration example extracted from README.md for Claude Desktop and other clients.

🤖 Evaluated by gemini-2.5-flashFix

{
  "mcp-zotero": {
    "command": "mcp-zotero",
    "args": [],
    "env": {}
  },
  "mcp-zotero-npx": {
    "command": "npx",
    "args": [
      "-y",
      "mcp-zotero"
    ],
    "env": {}
  },
  "mcp-zotero-configured": {
    "command": "mcp-zotero",
    "args": [],
    "env": {
      "ZOTERO_API_KEY": "YOUR_API_KEY",
      "ZOTERO_USER_ID": "YOUR_USER_ID"
    }
  }
}

MCP Protocol Support

Implemented MCP protocol features

🤖 Evaluated by gemini-2.5-flashFix

Tools:✓

Prompts:✗

Resources:✗

Sampling:✗

Roots:✗

Logging:✗

STDIO Transport:✓

HTTP Transport:✗

OAuth2 Auth:✗

Dependencies

4 dependencies

Libraries and frameworks used by this MCP server

🤖 Evaluated by gemini-2.5-flashFix

Main

@modelcontextprotocol/sdk

zotero-api-client

Medium

zod

Light

dotenv

README.md

MCP Zotero

NPM Version

A Model Context Protocol server for Zotero integration that allows Claude to interact with your Zotero library.

Setup

Get your Zotero credentials:

# First, create an API key at https://www.zotero.org/settings/keys
# Then use it to get your user ID:
curl -H "Zotero-API-Key: YOUR_API_KEY" https://api.zotero.org/keys/current

The response will look like:

{
  "userID": 123456,
  "username": "your_username",
  "access": {
    "user": {
      "library": true,
      "files": true,
      "notes": true,
      "write": true
    }
  }
}

The userID value is what you need.

Set environment variables:

export ZOTERO_API_KEY="your-api-key"
export ZOTERO_USER_ID="user-id-from-curl"

Verify your credentials:

# Test that your credentials work:
curl -H "Zotero-API-Key: $ZOTERO_API_KEY" \
     "https://api.zotero.org/users/$ZOTERO_USER_ID/collections"

You should see your collections list in the response.

Install and run:

# Install globally (recommended)
npm install -g mcp-zotero
mcp-zotero

# Or run directly with npx
npx mcp-zotero

Integration with Claude Desktop

To use this server with Claude Desktop, add the following to your Claude Desktop configuration:

{
  "mcpServers": {
    "zotero": {
      "command": "mcp-zotero",
      "env": {
        "ZOTERO_API_KEY": YOUR_API_KEY,
        "ZOTERO_USER_ID": YOUR_USER_ID
      }
    }
  }
}

Available Tools

get_collections: List all collections in your library
get_collection_items: Get items in a specific collection
get_item_details: Get detailed information about a paper
search_library: Search your entire library
get_recent: Get recently added papers

Troubleshooting

If you encounter any issues:

Verify your environment variables are set:

echo $ZOTERO_API_KEY
echo $ZOTERO_USER_ID

Check the installation:
```
npm list -g mcp-zotero
```

Try reinstalling:

npm uninstall -g mcp-zotero
npm install -g mcp-zotero

Resources

GitHub Repository

Add Quality Badge

Show your MCP trust score in your README

[![Trust Score](https://archestra.ai/mcp-catalog/api/badge/quality/kaliaboi/mcp-zotero)](https://archestra.ai/mcp-catalog/kaliaboi__mcp-zotero)

Edit This Server Add New MCP Server Report an Issue

README.md

MCP Zotero

NPM Version

A Model Context Protocol server for Zotero integration that allows Claude to interact with your Zotero library.

Setup

Get your Zotero credentials:

# First, create an API key at https://www.zotero.org/settings/keys
# Then use it to get your user ID:
curl -H "Zotero-API-Key: YOUR_API_KEY" https://api.zotero.org/keys/current

The response will look like:

{
  "userID": 123456,
  "username": "your_username",
  "access": {
    "user": {
      "library": true,
      "files": true,
      "notes": true,
      "write": true
    }
  }
}

The userID value is what you need.

Set environment variables:

export ZOTERO_API_KEY="your-api-key"
export ZOTERO_USER_ID="user-id-from-curl"

Verify your credentials:

# Test that your credentials work:
curl -H "Zotero-API-Key: $ZOTERO_API_KEY" \
     "https://api.zotero.org/users/$ZOTERO_USER_ID/collections"

You should see your collections list in the response.

Install and run:

# Install globally (recommended)
npm install -g mcp-zotero
mcp-zotero

# Or run directly with npx
npx mcp-zotero

Integration with Claude Desktop

To use this server with Claude Desktop, add the following to your Claude Desktop configuration:

{
  "mcpServers": {
    "zotero": {
      "command": "mcp-zotero",
      "env": {
        "ZOTERO_API_KEY": YOUR_API_KEY,
        "ZOTERO_USER_ID": YOUR_USER_ID
      }
    }
  }
}

Available Tools

get_collections: List all collections in your library
get_collection_items: Get items in a specific collection
get_item_details: Get detailed information about a paper
search_library: Search your entire library
get_recent: Get recently added papers

Troubleshooting

If you encounter any issues:

Verify your environment variables are set:

echo $ZOTERO_API_KEY
echo $ZOTERO_USER_ID

Check the installation:
```
npm list -g mcp-zotero
```

Try reinstalling:

npm uninstall -g mcp-zotero
npm install -g mcp-zotero