# Paper Librarian

> Paper Librarian is an open-source MCP server for health and science. Local searchable library of research papers with cited answers for Claude. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows, Self-hosted
- **Repository:** https://github.com/neelghoshal/mcp/tree/HEAD/paper-librarian
- **MCP Registry name:** io.github.NeelGhoshal/paper-librarian
- **Categories:** [health and science](https://ai-powered.com/categories/health-and-science), [academic research](https://ai-powered.com/categories/academic-research)
- **Listing updated:** 2026-11-21

## About

Paper Librarian keeps your research PDFs and arXiv papers in a single local database that an MCP client can query. Papers are added by arXiv id, URL or file path, then split into sections, pages and searchable passages, so answers can point back to the section and page they came from.

Search combines meaning-based vector matching with keyword ranking. Reference lists are parsed and matched to other papers in the library, so you can see which papers cite each other in both directions. Notes can be attached to any paper, and a section reader and a comparison helper pull relevant passages for side-by-side tables.

It suits students and researchers who work from a stack of papers and want an assistant to answer questions from the actual text. Papers, the database and the embedding model stay on the local machine, apart from arXiv downloads and a one-time model download.

## Features

- **Cited passage search:** Hybrid vector and keyword search returns passages labelled with paper, section and page.
- **Two-way citation links:** Reference lists are matched to library papers and linked forwards and backwards as papers are added.
- **arXiv and PDF ingestion:** Adds papers from an arXiv id, arXiv URL or a local PDF, skipping duplicates by id or file hash.
- **Section reader:** Retrieves the full text of a named section from a stored paper.
- **Paper comparison:** Gathers the most relevant passages per paper for each aspect you want compared.
- **Attached notes:** Stores free-text notes against a paper and returns them when the paper is looked up.
- **Local storage:** Keeps the database, PDFs and embedding model on your own machine in one folder.

## Good for

- Ask questions across a set of papers and get answers that cite section and page
- Map which papers in a reading list cite each other
- Build a comparison table of methods or results across several papers
- Draft a literature review from papers already in the library
- Keep private research PDFs searchable without uploading them to a service

## Install

### Claude Code (Terminal)

```sh
claude mcp add paper-librarian -- uvx paper-librarian
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "paper-librarian": {
      "command": "uvx",
      "args": [
        "paper-librarian"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "paper-librarian": {
      "command": "uvx",
      "args": [
        "paper-librarian"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "paper-librarian": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "paper-librarian"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "paper-librarian": {
      "command": "uvx",
      "args": [
        "paper-librarian"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "paper-librarian": {
      "command": "uvx",
      "args": [
        "paper-librarian"
      ]
    }
  }
}
```

## Tools

- `add_paper`: Adds a paper by arXiv id or PDF path.
- `search`: Searches the library in hybrid, semantic or keyword mode with year and paper filters.
- `get_paper`: Returns paper metadata, notes, or one section's full text.
- `get_citations`: Lists a paper's references and the papers that cite it.
- `compare_papers`: Gathers passages from several papers for each comparison aspect.
- `add_note`: Attaches a note to a paper.
- `list_papers`: Lists papers in the library.
- `remove_paper`: Removes a paper from the library, keeping its PDF file.

## FAQ

### Does Paper Librarian need an external service?

Only arXiv for downloads and a one-time download of the embedding model; the database and PDFs stay local.

### Can Paper Librarian read scanned PDFs?

No. Scanned PDFs without a text layer are rejected, and there is no OCR.

### Which clients can use Paper Librarian?

It runs over stdio and is set up for Claude Code and Claude Desktop, and works with any MCP client.

### Where is the library stored?

In the folder set by LIBRARIAN_HOME, defaulting to ~/.librarian, which holds library.db and a pdfs folder.

### Is Paper Librarian free?

Yes. Paper Librarian is open source, so you can use and self-host it for free.

### How do I add Paper Librarian to Claude Code?

Run this command in your terminal: claude mcp add paper-librarian -- uvx paper-librarian

### What are the best alternatives to Paper Librarian?

The closest alternatives to Paper Librarian are Arxiv MCP Server, Peer Research Papers MCP, Paper Finder, Scholar Feed and Endnote MCP.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Arxiv MCP Server](https://ai-powered.com/mcp/arxiv-mcp-server): Arxiv MCP Server is an open-source MCP server for health and science.
- [Peer Research Papers MCP](https://ai-powered.com/mcp/peer-research-papers-mcp): Peer Research Papers MCP is a paid MCP server for health and science.
- [Paper Finder](https://ai-powered.com/mcp/paper-finder): Paper Finder is a free MCP server for health and science.
- [Scholar Feed](https://ai-powered.com/mcp/scholar-feed): Scholar Feed is an open-source MCP server for academic research.
- [Endnote MCP](https://ai-powered.com/mcp/endnote-mcp): Endnote MCP is an open-source MCP server for academic research.
- [MCP Scholaris](https://ai-powered.com/mcp/mcp-scholaris): MCP Scholaris is an open-source MCP server for health and science.
- [PaperList](https://ai-powered.com/mcp/paperlist): PaperList is a freemium MCP server for academic research.
- [Biolab MCP Server](https://ai-powered.com/mcp/biolab-mcp-server): Biolab MCP Server is an open-source MCP server for academic research.

---
Source: https://ai-powered.com/mcp/paper-librarian
