# blazickjp/arxiv-mcp-server [Health: Active]

**Category:** 🔎 Search & Data Extraction  
**Repository:** https://github.com/blazickjp/arxiv-mcp-server  
**GitHub Stars:** 3125  
**npm Downloads (last month):** 491  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/blazickjp-arxiv-mcp-server

## Description
A Model Context Protocol server for searching and analyzing arXiv papers

## Tools
Capabilities this server exposes over MCP:

- **search_papers** — Search arXiv by query, category, date, and sort order
- **get_abstract** — Fetch metadata and an abstract by arXiv ID
- **download_paper** — Download and convert a paper to local Markdown
- **list_papers** — List papers stored locally
- **read_paper** — Read locally stored paper content
- **get_paper_outline** — Paginated markdown heading outline
- **read_paper_section** — Read one bounded markdown section
- **search_paper_text** — Bounded passage search in a paper
- **get_paper_latex** — Retrieve bounded author-submitted LaTeX
- **list_paper_latex_sections** — Return a paginated LaTeX outline
- **get_paper_latex_section** — Read one bounded LaTeX section
- **citation_graph** — Fetch references and citing papers
- **export_citations** — Export BibTeX for one or more arXiv IDs
- **watch_topic** — Save or update an arXiv topic watch
- **list_watches** — List saved topic watches
- **check_alerts** — Check saved watches for new papers
- **unwatch_topic** — Delete a saved topic watch
- **semantic_search** — Search downloaded papers by semantic similarity
- **reindex** — Rebuild the local semantic index

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "arxiv-mcp-server": {
    "command": "uvx",
    "args": ["arxiv-mcp-server"]
  }
}
```

## Documentation

## What blazickjp/arxiv-mcp-server MCP server does

The blazickjp/arxiv-mcp-server MCP server supports an end-to-end workflow for working with arXiv literature. Agents can search by query, category, date, and sort order, then retrieve metadata and abstracts using an arXiv identifier. Downloaded papers are converted to local Markdown so later operations can inspect the stored content without repeatedly fetching the document.

The server also exposes the author-submitted LaTeX for downloaded papers in bounded sections. This is useful when the Markdown conversion does not provide enough detail or when an agent needs to inspect source structure. Citation tools retrieve references and citing papers, and can export BibTeX entries for one or more arXiv IDs.

## How it works

The blazickjp/arxiv-mcp-server MCP server runs locally over stdio. Its default paper directory is `~/.arxiv-mcp-server/papers`; a different absolute storage path can be supplied at launch. The basic working sequence is to identify a paper, download it, inspect its outline, and read only the relevant Markdown or LaTeX section. Tools for bounded passage search and paginated outlines help keep individual responses focused.

Searches, downloads, source retrieval, and citation graph requests call their relevant external services. Stored papers, semantic indexes, and topic watches are handled locally. Semantic search operates over downloaded papers, while `reindex` rebuilds the local semantic index when needed. Topic watches can be created, listed, checked for new papers, updated, or removed.

## Setup and configuration

The documented installation uses the PyPI package through `uvx`:

```bash
uvx arxiv-mcp-server
```

The command requires `uv`, which provides `uvx`; no repository clone or separate Python environment is required. Clients that accept an `mcpServers` configuration can launch it with a stdio entry using `uvx` as the command and `arxiv-mcp-server` as its argument. Claude Desktop is given as an example of such a client, and a Cursor installation link is provided by the project.

To change where papers are stored, add `--storage-path` followed by an absolute directory path to the launch arguments. If a desktop application cannot locate `uvx` even though it works in a terminal, configure the client with the executable's absolute path. The published package is available as `arxiv-mcp-server==0.7.2`.

## Tools and capabilities

The blazickjp/arxiv-mcp-server MCP server exposes tools for:

- Searching papers and retrieving abstracts and metadata.
- Downloading papers to local Markdown and listing or reading stored papers.
- Viewing Markdown outlines, sections, and bounded text matches.
- Retrieving bounded LaTeX, listing LaTeX sections, and reading individual source sections.
- Traversing citation relationships and exporting BibTeX.
- Saving topic watches, checking alerts, and removing watches.
- Searching downloaded papers by semantic similarity and rebuilding the local index.

These capabilities support literature discovery, focused paper review, source-level inspection, citation collection, and recurring topic monitoring.

## Limitations and notes

This is a local server rather than a hosted endpoint, so the client machine must have `uv` available unless a supported desktop bundle is used. The Claude Desktop bundle described by the project is for macOS and requires CPython 3.11.x. The server depends on the relevant external arXiv services for online search, paper retrieval, and citation operations; local tools require the corresponding papers or indexes to already exist.

The project warns that an unrelated npm package has the same name. Installation should therefore use the PyPI package through `uvx`, not npm, pnpm, or `npx`. The repository is licensed under Apache-2.0.

_Full upstream README: https://allmcps.com/mcp/blazickjp-arxiv-mcp-server/readme_