MCP ExplorerExplorer

Mcp Zotero

@kaliaboion 22 days ago
106 MIT
FreeCommunity
AI Systems
A connector for Claude Desktop to work with collection and sources on your Zotero Cloud.

Overview

What is Mcp Zotero

mcp-zotero is a Model Context Protocol server designed for integrating Zotero with Claude Desktop, allowing users to interact with their Zotero library seamlessly.

Use cases

Use cases include managing research papers, organizing bibliographic data, and facilitating collaborative research projects by integrating Zotero’s capabilities with Claude Desktop.

How to use

To use mcp-zotero, first obtain your Zotero API key and user ID, set the required environment variables, and then install the server using npm. Finally, configure Claude Desktop to connect with mcp-zotero.

Key features

Key features include the ability to list all collections in your Zotero library and retrieve specific items. It provides a straightforward integration process with Claude Desktop.

Where to use

mcp-zotero can be used in academic research, personal knowledge management, and any field that requires effective citation and reference management.

Content

MCP Zotero

NPM Version smithery badge

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

Zotero MCP server

Setup

  1. 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.

  2. Set environment variables:

    export ZOTERO_API_KEY="your-api-key"
    export ZOTERO_USER_ID="user-id-from-curl"
    
  3. 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.

  4. 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:

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:

  1. Verify your environment variables are set:

    echo $ZOTERO_API_KEY
    echo $ZOTERO_USER_ID
    
  2. Check the installation:

    npm list -g mcp-zotero
    
  3. Try reinstalling:

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

Tools

No tools

Comments

Recommend MCP Servers

View All MCP Servers