Skip to main content
Glama

arXiv MCP Server

PyPI version Python License: MIT

A Model Context Protocol (MCP) server that enables LLMs to search, download, and read arXiv papers. Gives AI assistants direct access to scientific literature.

Features

  • Search papers - Search by title, keywords, author, or arXiv ID

  • Read full text - Download PDFs and extract text automatically

  • Section extraction - Get specific sections (abstract, introduction, methods, conclusion)

  • Local caching - Downloaded papers are cached locally for fast re-access

  • Zero configuration - Works out of the box with sensible defaults

Related MCP server: arXiv MCP Server

Getting Started

Prerequisites

This MCP server uses uvx to run. First, install uv:

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Or using Homebrew
brew install uv

After installation, restart your terminal.

Installation

Install the arXiv MCP server with your client.

Standard config works in most tools:

{
  "mcpServers": {
    "arxiv": {
      "command": "uvx",
      "args": ["arxiv-paper-mcp-server"]
    }
  }
}
amp mcp add arxiv -- uvx arxiv-paper-mcp-server
claude mcp add arxiv-server -- uvx arxiv-paper-mcp-server

Add to your claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "arxiv": {
      "command": "uvx",
      "args": ["arxiv-paper-mcp-server"]
    }
  }
}
codex mcp add arxiv -- uvx arxiv-paper-mcp-server

Add to ~/.cursor/mcp.json:

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

Add to Factory MCP settings:

{
  "mcpServers": {
    "arxiv": {
      "command": "uvx",
      "args": ["arxiv-paper-mcp-server"]
    }
  }
}
gemini mcp add arxiv -- uvx arxiv-paper-mcp-server

Run goose configure, then add to ~/.config/goose/config.yaml:

extensions:
  arxiv:
    command: uvx
    args:
      - arxiv-paper-mcp-server

Add to Kiro MCP settings:

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

Add to LM Studio MCP settings:

{
  "mcpServers": {
    "arxiv": {
      "command": "uvx",
      "args": ["arxiv-paper-mcp-server"]
    }
  }
}
opencode mcp add arxiv -- uvx arxiv-paper-mcp-server

Add to Qodo Gen MCP configuration:

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

Add to .vscode/mcp.json in your workspace:

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

Add to Warp MCP settings:

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

Add to ~/.windsurf/mcp.json:

{
  "mcpServers": {
    "arxiv": {
      "command": "uvx",
      "args": ["arxiv-paper-mcp-server"]
    }
  }
}
pip install arxiv-paper-mcp-server
arxiv-mcp-server

Tools

Tool

Description

search

Search arXiv papers by title, keywords, or arXiv ID (e.g., 2401.12345)

get_paper

Download and read the full text of a paper, with optional section filtering

list_downloaded_papers

List all locally cached papers

Tool Details

search(query, max_results=10)

Search for papers on arXiv. Supports:

  • Keywords: "transformer attention mechanism"

  • Paper ID: "2401.12345" or "arXiv:2401.12345"

  • Author: "Yann LeCun"

Returns paper ID, title, authors, publication date, and abstract preview.

get_paper(paper_id, section="all")

Download and extract text from a paper.

Section

Description

all

Full paper text (default)

abstract

Abstract only

introduction

Introduction section

method

Methods/Approach section

conclusion

Conclusion/Discussion section

list_downloaded_papers()

List all papers that have been downloaded and cached locally.

Configuration

Environment Variable

Description

Default

ARXIV_STORAGE_DIR

Directory for downloaded papers

~/.arxiv-mcp/papers

Usage Examples

Search for papers:

User: Find recent papers about prompt compression

Claude: [Uses search("prompt compression", max_results=5)]
Found 5 papers:
- 2504.16574: PIS: Linking Importance Sampling...
- ...

Read a specific paper:

User: Read the introduction of paper 2401.12345

Claude: [Uses get_paper("2401.12345", section="introduction")]
[Returns the introduction section]

Review cached papers:

User: What papers have I downloaded?

Claude: [Uses list_downloaded_papers()]
You have 3 papers cached locally:
- 2401.12345: Paper Title...

Development

# Clone the repository
git clone https://github.com/AnnaSuSu/arxiv-mcp.git
cd arxiv-mcp

# Install dependencies
uv sync

# Run server locally
uv run arxiv-mcp-server

Requirements

  • Python 3.10+

  • Dependencies: mcp, arxiv, pymupdf

License

MIT License - see LICENSE for details.

Available Tools

3 tools
get_paperA

Get the full text of an arXiv paper.

Args:
    paper_id: arXiv paper ID (e.g., "2401.12345")
    section: Which section to return: "all", "abstract", "introduction", "method", "conclusion"

Returns:
    The paper text (full or specified section)

Inputs: paper_id (required), section. Returns: result

list_downloaded_papersB

List all locally downloaded papers.

Returns:
    List of downloaded papers with their metadata

Inputs: no named parameters. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no overlap: get_paper retrieves full text or sections of a specific paper, list_downloaded_papers shows locally stored papers, and search finds papers based on queries. The descriptions make it easy to differentiate between retrieving, listing local content, and searching.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (get_paper, list_downloaded_papers, search), using snake_case throughout. The naming is predictable and readable, with no deviations or mixed conventions.

    Tool Count3/5

    With only 3 tools, the server feels thin for an arXiv domain that might benefit from more operations like filtering searches, managing downloads, or accessing metadata. While the tools cover basic needs, the count is borderline low for comprehensive arXiv interaction.

    Completeness3/5

    The tools cover core arXiv operations (search, retrieve, list local), but there are notable gaps such as no ability to download papers, update local storage, or access advanced metadata. Agents can work around this by using existing tools, but the surface is incomplete for full paper management workflows.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables searching, downloading, and managing academic papers from arXiv.org through natural language interactions. Provides tools for paper discovery, PDF downloads, and local paper collection management.
      4
      1
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables arXiv paper search, PDF download, text extraction, and context chunking for LLM pipelines, along with advanced features like citation graphs and reproducibility scoring.
      2
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables LLM agents to search arXiv, download papers, parse PDFs into structured sections, and extract key findings using client-side LLMs. Features persistent caching and layout-aware PDF extraction.
      6
      MIT