ryogena-pubmed-mcp
Provides tools to search PubMed, fetch abstracts, find related articles, and search by author, enabling literature retrieval and citation graph walking.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@ryogena-pubmed-mcp Find recent papers on CRISPR gene editing"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ryogena-pubmed-mcp
A small, focused Model Context Protocol server that exposes NCBI PubMed as MCP tools, so any MCP-compatible client (Claude Desktop, Claude Code, custom agents) can search the literature, fetch abstracts, walk the citation graph, and look up an author's publications without leaving the chat.
No API key required. An optional NCBI_API_KEY raises the rate limit
from 3 → 10 requests/sec.
Tools
Tool | What it does |
| Free-text or full-syntax PubMed query. Returns title, authors, journal, pubdate, DOI, PubMed URL. |
| Full abstract for one PMID, with section labels preserved (Background / Methods / Results / Conclusions). |
| NCBI's "related articles" neighbors — walk the citation graph from any paper. |
| Author publication list using the |
All tools are read-only; PubMed itself is read-only.
Related MCP server: mcp-pubmed
Install
pip install ryogena-pubmed-mcpOr from source:
git clone https://github.com/KyleVick4/pubmed-mcp
cd pubmed-mcp
pip install -e .Configure in Claude Desktop
Edit your claude_desktop_config.json:
{
"mcpServers": {
"pubmed": {
"command": "python",
"args": ["-m", "pubmed_mcp"],
"env": {
"NCBI_API_KEY": "<optional>",
"NCBI_EMAIL": "<optional, recommended by NCBI>"
}
}
}
}Restart Claude Desktop. The pubmed server should show up in the MCP
panel with four tools.
Configure in Claude Code
claude mcp add pubmed -- python -m pubmed_mcpTry it
Once wired up:
Find me the three most-cited papers on JAK2 V617F selectivity from 2023, then pull the abstract of the top hit.
Claude will plan a search_pubmed → fetch_article chain and cite each
paper with its DOI and PubMed URL.
Verify the server before debugging your client
Use the MCP Inspector — it's the fastest way to see if the server starts cleanly and the tools register:
npx @modelcontextprotocol/inspector python -m pubmed_mcpRun the tests
The test suite is hermetic — no NCBI requests, no network. Every HTTP
call is intercepted by httpx.MockTransport.
pip install -e ".[dev]"
pytest -vWhy this exists
I built Pico, a closed-source AI-native drug discovery platform, with its own MCP server that exposes molecule and assay tools to Claude Desktop. Building ryogena-pubmed-mcp in the open lets me share the integration patterns I use — slim LLM-friendly projections, hermetic test design, error-envelope contracts — without exposing the domain code.
If you're building an MCP server and want a tiny reference, the
server.py and
tests/test_tools.py files together are about
500 lines and demonstrate the full pattern.
License
MIT — see LICENSE.
Available Tools
4 toolsfetch_articleA
Fetch one article with full abstract text.
Returns title, abstract (with section labels preserved if structured),
authors, journal, pubdate, DOI, and a clickable PubMed URL. Returns
{"error": "NOT_FOUND"} if the PMID is invalid.
Inputs: pmid (required). Returns: object
search_by_authorA
Find an author's PubMed-indexed publications.
Wraps search_pubmed with the [au] field qualifier so partial-name
matches don't pollute the result. Newest-first by default — flip sort
to 'relevance' to surface most-cited / highest-impact first.
Inputs: author (required), sort, max_results. Returns: object
search_pubmedA
Search PubMed and return slim metadata for each hit.
Two-step under the hood: esearch gets PMIDs, esummary gets
title/authors/journal/pubdate/DOI for each. Use fetch_article next
when you need the full abstract for a specific result.
Inputs: query (required), sort, max_results. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: fetch_article gets full text for a PMID, find_related walks citation neighbors, search_by_author targets author queries, and search_pubmed does general search. No overlap in functionality.
All tool names follow a consistent verb_noun pattern with underscores: fetch_article, find_related, search_by_author, search_pubmed. Verbs are descriptive and nouns are specific.
Four tools cover the core PubMed operations (search, fetch, related articles) without unnecessary duplication. The number is within the recommended 3-15 range and well-scoped for the purpose.
The tool set covers the main workflows: searching (general and by author), fetching full articles, and exploring related papers. Minor gaps exist, such as search by topic/MeSH or filtering by date, but agents can accomplish common tasks without dead ends.
Maintenance
Related MCP Connectors
PubMed MCP — wraps the NCBI E-utilities API (biomedical literature, free, no auth)
Search biomedical literature, get article details, find related articles, and explore MeSH terms
Search biomedical papers, inspect publication records, and traverse citation or semantic graphs.
Search PubMed/Europe PMC, fetch articles and full text (PMC/EPMC/Unpaywall), citations, MeSH terms.
Related MCP Servers
- AlicenseBqualityDmaintenanceProvides comprehensive access to NCBI's PubMed database of over 36 million biomedical citations, allowing users to search, retrieve, and analyze literature directly through MCP tools. It supports advanced queries, citation management, full-text retrieval from PubMed Central, and precise discovery using MeSH terms.1615MIT
- AlicenseNot gradedqualityBmaintenanceEnables searching and retrieving biomedical literature from PubMed via the NCBI E-utilities API.405 npm1MIT
- AlicenseNot gradedqualityDmaintenanceProvides advanced PubMed literature search, retrieval of article details and abstracts, citation export in multiple formats, author and MeSH term searches, related article discovery, journal analysis, and research trend analysis through the Model Context Protocol.MIT
- AlicenseNot gradedqualityAmaintenanceEnables searching PubMed and Europe PMC, fetching article metadata and full text with fallbacks, resolving citations and IDs, formatting references, and looking up MeSH terms via MCP over STDIO or Streamable HTTP.9 npmMIT