# pubmed-stream

> pubmed-stream is an open-source MCP server for health and science. Search PubMed and PMC, read full texts, map citations and build Obsidian knowledge graphs. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, Windows
- **Website:** https://melhzy.github.io/pubmed-stream/
- **Repository:** https://github.com/melhzy/pubmed-stream
- **MCP Registry name:** io.github.melhzy/pubmed-stream
- **Categories:** health and science, knowledge and memory
- **Listing updated:** 2026-11-15

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add pubmed-stream --env NCBI_API_KEY='<NCBI_API_KEY>' -- uvx pubmed-stream
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "pubmed-stream": {
      "command": "uvx",
      "args": [
        "pubmed-stream"
      ],
      "env": {
        "NCBI_API_KEY": "<NCBI_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "pubmed-stream": {
      "command": "uvx",
      "args": [
        "pubmed-stream"
      ],
      "env": {
        "NCBI_API_KEY": "<NCBI_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "pubmed-stream": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "pubmed-stream"
      ],
      "env": {
        "NCBI_API_KEY": "<NCBI_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "pubmed-stream": {
      "command": "uvx",
      "args": [
        "pubmed-stream"
      ],
      "env": {
        "NCBI_API_KEY": "<NCBI_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "pubmed-stream": {
      "command": "uvx",
      "args": [
        "pubmed-stream"
      ],
      "env": {
        "NCBI_API_KEY": "<NCBI_API_KEY>"
      }
    }
  }
}
```

## 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

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Tooluniverse](https://ai-powered.com/mcp/tooluniverse): Tooluniverse is an open-source MCP server for health and science.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [Oya Browser](https://ai-powered.com/mcp/oya-browser): Oya Browser is a freemium MCP server for browser automation.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [Later Stages](https://ai-powered.com/mcp/later-stages): Later Stages is a free MCP server for health and science.

---
Source: https://ai-powered.com/mcp/pubmed-stream
