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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a13b6869c3627401fcdbdf5d897fb5b28cfde6e496fb1037c9e96ac2bc685c8d
|
|
| MD5 |
a8fb18764ccf8a8578d8e37f40fb666d
|
|
| BLAKE2b-256 |
bd4285e73b7bf57956cdd95ad1bc21529b713f214b2e8d60f9753de6db85791b
|
File details
Details for the file orcid_mcp_server-1.0.0-py3-none-any.whl.
File metadata
- Download URL: orcid_mcp_server-1.0.0-py3-none-any.whl
- Upload date:
- Size: 7.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
629aa6d3c27c6f57845d06c0f1b16f5512cbe67344029ac27d6199a8b72f9b36
|
|
| MD5 |
2235352ac333565fd8091072cae6c039
|
|
| BLAKE2b-256 |
089441d8de60dafb304c34bc5c70ad98bdc23534944ba0f7a1ed79a2f5cbe9cf
|