pubmed-stream
Search PubMed and PMC, read full texts, map citations and build Obsidian knowledge graphs
- Pricing
- Open source
- Platforms
- CLI, Linux, macOS
- Runs
- Locally
- Version
- 0.4.4
- Listing updated
- 2 days ago
About pubmed-stream
pubmed-stream is an open-source MCP server for health and science. It runs locally on your machine and is started by your AI client.
pubmed-stream is a Python library and command-line tool built on NCBI's official E-utilities API, and the same functions are offered to assistants through this stdio server, a Claude Code and Codex plugin, and Gemini CLI. The aim is answers that cite only papers the assistant actually downloaded and read.
You can size a search before downloading anything, then bulk-download full-text articles from PubMed Central as JSON with references, or fetch abstracts where full text is not free. Citations export to BibTeX or RIS for Zotero, EndNote and Mendeley. A literature map finds citing, cited and similar papers and flags retractions, reviews and NIH funding, and a knowledge-graph step writes one Obsidian note per paper and MeSH concept. Abstracts can be summarized with a local model through Ollama, so nothing leaves the machine. An optional free NCBI API key raises the request limit from 3 to 10 per second. MIT licensed, installed from PyPI.
Install
Run in a terminal
claude mcp add pubmed-stream --env NCBI_API_KEY='<NCBI_API_KEY>' -- uvx pubmed-streamAdd to claude_desktop_config.json
{
"mcpServers": {
"pubmed-stream": {
"command": "uvx",
"args": [
"pubmed-stream"
],
"env": {
"NCBI_API_KEY": "<NCBI_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"pubmed-stream": {
"command": "uvx",
"args": [
"pubmed-stream"
],
"env": {
"NCBI_API_KEY": "<NCBI_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"pubmed-stream": {
"type": "stdio",
"command": "uvx",
"args": [
"pubmed-stream"
],
"env": {
"NCBI_API_KEY": "<NCBI_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"pubmed-stream": {
"command": "uvx",
"args": [
"pubmed-stream"
],
"env": {
"NCBI_API_KEY": "<NCBI_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"pubmed-stream": {
"command": "uvx",
"args": [
"pubmed-stream"
],
"env": {
"NCBI_API_KEY": "<NCBI_API_KEY>"
}
}
}
}Configuration
NCBI_API_KEYOptional free NCBI API key, which raises NCBI's limit from 3 to 10 requests a second; create it under API Key Management at https://account.ncbi.nlm.nih.gov/settings/NCBI_EMAILOptional contact email that NCBI asks programs to send with their requests
What it does
- Search with MeSH
- Searches PubMed and PMC with field tags and MeSH, counting results first.
- Full-text download
- Bulk-downloads PMC articles as JSON with metadata and references.
- Citation export
- Exports BibTeX or RIS for reference managers.
- Evidence mapping
- Finds citing, cited and similar papers, flagging retractions.
- Obsidian knowledge graph
- Writes linked notes per paper and MeSH concept.
- Local summaries
- Summarizes abstracts with Ollama on your own machine.
Good for
- Reviewing the literature on a topic with only papers actually read
- Mapping how a retracted paper spread through citations
- Building a linked Obsidian vault of a field
- Exporting a reference list to Zotero or EndNote
Pricing
Open source
MIT licensed; free
Prices change. Check melhzy.github.io before you buy.
pubmed-stream FAQ
Do I need an API key?
No. An optional free NCBI key raises the limit from 3 to 10 requests a second.
Which assistants can use it?
Claude Code and Codex through a plugin, and those plus Gemini CLI through the MCP server.
Can summaries stay local?
Yes, abstracts can be summarized with a local LLM through Ollama.
What licence is it?
MIT.
Is pubmed-stream free?
Yes. pubmed-stream is open source, so you can use and self-host it for free.
How do I add pubmed-stream to Claude Code?
Run this command in your terminal: claude mcp add pubmed-stream --env NCBI_API_KEY='<NCBI_API_KEY>' -- uvx pubmed-stream
What are the best alternatives to pubmed-stream?
The closest alternatives to pubmed-stream are Codebase Memory, XERJ, Claude Code Ultimate Guide, Tooluniverse and Nautilus Compass Memory.
Alternatives to pubmed-stream

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Claude Code Ultimate Guide
MCP serverMCP server for searching the Claude Code Ultimate Guide from any MCP client
Runs locally- Open source
- 6.5K GitHub stars
- AI models and LLM tooling

Tooluniverse
MCP serverMCP server giving AI agents access to thousands of scientific research tools
Runs locally- Open source
- 1.8K GitHub stars
- Health and science

Nautilus Compass Memory
MCP serverLocal-first long-term memory layer for AI agents, served over MCP
Not checked yet- 5 tools
- Remote
- Open source
- 1.3K GitHub stars
- Knowledge and memory

Oya Browser
MCP serverHIPAA-oriented agentic browser with replayable playbooks, reachable over MCP
- 32 tools
- Remote
- Freemium
- 349 GitHub stars
- Browser automation