Skip to main content

MCP server for the ORCID API — search researchers, read profiles, and export citations

Project description

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

Tool Description
orcid_search Search for researchers by name, affiliation, keyword, DOI, or advanced Solr query
orcid_read_record Read a researcher's full profile (bio, employment, education, keywords)
orcid_read_works Get publications from a researcher's ORCID record
orcid_export_ris Export retrieved works as RIS (for Zotero, EndNote, etc.)
orcid_export_bibtex Export 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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

orcid_mcp_server-1.0.0.tar.gz (6.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

orcid_mcp_server-1.0.0-py3-none-any.whl (7.7 kB view details)

Uploaded Python 3

File details

Details for the file orcid_mcp_server-1.0.0.tar.gz.

File metadata

  • Download URL: orcid_mcp_server-1.0.0.tar.gz
  • Upload date:
  • Size: 6.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.6

File hashes

Hashes for orcid_mcp_server-1.0.0.tar.gz
Algorithm Hash digest
SHA256 a13b6869c3627401fcdbdf5d897fb5b28cfde6e496fb1037c9e96ac2bc685c8d
MD5 a8fb18764ccf8a8578d8e37f40fb666d
BLAKE2b-256 bd4285e73b7bf57956cdd95ad1bc21529b713f214b2e8d60f9753de6db85791b

See more details on using hashes here.

File details

Details for the file orcid_mcp_server-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for orcid_mcp_server-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 629aa6d3c27c6f57845d06c0f1b16f5512cbe67344029ac27d6199a8b72f9b36
MD5 2235352ac333565fd8091072cae6c039
BLAKE2b-256 089441d8de60dafb304c34bc5c70ad98bdc23534944ba0f7a1ed79a2f5cbe9cf

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page