English Français العربية

io.github.SMABoundless/orcid

Official registry Search and web

Search ORCID researcher profiles, retrieve works, and export citations

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package orcid-mcp-server
Claude Code 
claude mcp add orcid -e 'ORCID_CLIENT_ID=<your orcid_client_id>' -e 'ORCID_CLIENT_SECRET=<your orcid_client_secret>' -- uvx orcid-mcp-server==1.0.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "orcid": {
            "command": "uvx",
            "args": [
                "orcid-mcp-server==1.0.0"
            ],
            "env": {
                "ORCID_CLIENT_ID": "<your orcid_client_id>",
                "ORCID_CLIENT_SECRET": "<your orcid_client_secret>"
            }
        }
    }
}

Environment variables

  • ORCID_CLIENT_ID required secret ORCID API client ID from https://orcid.org/developer-tools
  • ORCID_CLIENT_SECRET required secret ORCID API client secret

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. ORCID MCP Server
  2. Tools
  3. Setup
  4. Usage examples
  5. License

ORCID MCP Server

An MCP (Model Context Protocol) server that provides tools for searching the ORCID registry, reading researcher profiles, retrieving publications, and exporting citations in RIS and BibTeX formats.

Built with FastMCP and the ORCID Public API v3.0.

Tools

ToolDescription
orcid_searchSearch for researchers by name, affiliation, keyword, DOI, or advanced Solr query
orcid_read_recordRead a researcher's full profile (bio, employment, education, keywords)
orcid_read_worksGet publications from a researcher's ORCID record
orcid_export_risExport retrieved works as RIS (for Zotero, EndNote, etc.)
orcid_export_bibtexExport retrieved works as BibTeX

Setup

1. Get ORCID API credentials

Register for free public API credentials at ORCID Developer Tools.

2. Install
cd orcid-mcp-server
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
3. Configure environment

Copy the example env file and add your credentials:

cp .env.example .env
# Edit .env with your ORCID_CLIENT_ID and ORCID_CLIENT_SECRET
4. Add to Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "orcid-mcp": {
      "command": "/path/to/orcid-mcp-server/venv/bin/python",
      "args": ["/path/to/orcid-mcp-server/server.py"],
      "env": {
        "ORCID_CLIENT_ID": "your-client-id",
        "ORCID_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Or if using Claude Code CLI:

claude mcp add orcid-mcp \
  /path/to/orcid-mcp-server/venv/bin/python \
  /path/to/orcid-mcp-server/server.py \
  -e ORCID_CLIENT_ID=your-client-id \
  -e ORCID_CLIENT_SECRET=your-client-secret

Usage examples

Once connected, you can ask Claude things like:

  • "Search ORCID for researchers at Northwestern University working on machine learning"
  • "Look up the ORCID profile for 0000-0002-1825-0097"
  • "Get the publications for this researcher and export them as RIS for Zotero"

License

MIT

Frequently asked questions

What is io.github.SMABoundless/orcid?

Search ORCID researcher profiles, retrieve works, and export citations

How do I install io.github.SMABoundless/orcid?

It runs on your machine. In Claude Code: claude mcp add orcid -e 'ORCID_CLIENT_ID=<your orcid_client_id>' -e 'ORCID_CLIENT_SECRET=<your orcid_client_secret>' -- uvx orcid-mcp-server==1.0.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.SMABoundless/orcid need an API key?

Yes. It expects ORCID_CLIENT_ID, ORCID_CLIENT_SECRET, which you set in its configuration.

Is io.github.SMABoundless/orcid open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.SMABoundless/orcid?

It is published by SMABoundless. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.