Get the FREE Ultimate OpenClaw Setup Guide →

arxiv

MCP server for searching and reading arXiv papers with LLMs

Installation
Run this command in your terminal to add the MCP server to Claude Code.
Run in terminal:
Command
claude mcp add --transport stdio annasusu-arxiv-mcp uvx arxiv-paper-mcp-server \
  --env ARXIV_STORAGE_DIR="Directory for downloaded papers (default: ~/.arxiv-mcp/papers)"

How to use

This MCP server provides a programmable interface to search arXiv, download full papers, and extract specific sections for reading and analysis. It exposes tools such as search, get_paper, and list_downloaded_papers. You can integrate these tools into your LLM workflows to fetch paper metadata, obtain the text of abstracts or sections, and reuse locally cached PDFs for faster access. The server runs via uvx and is designed to require minimal configuration, with a local storage directory for caching.

How to install

Prerequisites:

  • Python 3.10+ (for the arxiv-paper-mcp-server package when using pip to install the server wrapper)
  • uv (via uvx) installed on your system

Installation steps:

# 1) Install uv (if not already installed)
# macOS/Linux (uv install script)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Or via Homebrew
brew install uv
# 2) Install the arXiv MCP server package (Python-based)
pip install arxiv-paper-mcp-server
# 3) Run the MCP server locally (uvx-based start)
uv run arxiv-paper-mcp-server

Optional initial configuration

The server will use a default storage directory for downloaded papers.

You can customize it via the ARXIV_STORAGE_DIR environment variable when starting the server.

Additional notes

Environment variables and configuration:

  • ARXIV_STORAGE_DIR: Directory for downloaded papers. Default is ~/.arxiv-mcp/papers. Set this to a path with enough space for caching.

Common issues:

  • Ensure uvx is installed and available on your PATH before starting the server.
  • If you see permission or path errors, verify that the storage directory exists and is writable by the user running the MCP server.
  • When upgrading, re-check the server start command (uv run arxiv-paper-mcp-server) as the package name may vary slightly with versions.

Configuration tips:

  • Keep the cache directory on fast storage if you plan to download many papers.
  • The server exposes tools that return IDs, titles, authors, and abstracts; for full text, use get_paper with section parameters (all, abstract, introduction, method, conclusion).

Related MCP Servers

Sponsor this space

Reach thousands of developers