Skip to content
MCP server

pubmed-stream

Search PubMed and PMC, read full texts, map citations and build Obsidian knowledge graphs

Runs locallyStatus and history
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-stream

Add 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

  1. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  2. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  3. MCP 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
  4. Tooluniverse

    MCP server

    MCP server giving AI agents access to thousands of scientific research tools

    Runs locally
    • Open source
    • 1.8K GitHub stars
    • Health and science
  5. Local-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
  6. Oya Browser

    MCP server

    HIPAA-oriented agentic browser with replayable playbooks, reachable over MCP

    • 32 tools
    • Remote
    • Freemium
    • 349 GitHub stars
    • Browser automation