ArXiv MCP Server for Claude Code: Setup & Config

What you can do with ArXiv in Claude Code

A focused arXiv workflow from filtered discovery to locally stored, readable papers.

• Find papers within a topic, category, and date range.
• Use guided prompts for comparisons or literature reviews.

Before you start: ArXiv in Claude Code

• Python 3.11+
• uv
• An MCP-compatible client

Replace the example storage path with your paper directory. Install the [pdf] extra for PDF-only papers. The README also documents uvx and HTTP launch options.

ArXiv Claude Code configuration

1. Choose Claude Code configuration scope

   For ArXiv MCP Server, open Project scope: .mcp.json at the repository root. Project JSON: merge into mcpServers; user scope: use the CLI.

2. Add ArXiv MCP Server to Claude Code

   Use the arxiv-mcp-server entry below in mcpServers. Keep ArXiv MCP Server's documented stdio connection fields and your other Claude Code entries.

3. Check ArXiv MCP Server in Claude Code

   ArXiv MCP Server: Inspect claude mcp list and /mcp status.

{
  "mcpServers": {
    "arxiv-mcp-server": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "tool",
        "run",
        "arxiv-mcp-server",
        "--storage-path",
        "/path/to/paper/storage"
      ],
      "env": {}
    }
  }
}

claude mcp add-json --scope project 'arxiv-mcp-server' '{"type":"stdio","command":"uv","args":["tool","run","arxiv-mcp-server","--storage-path","/path/to/paper/storage"],"env":{}}'

ArXiv tools available to Claude Code

ArXiv's stored tool list documents 5 tools; compare it with Claude Code's connected tool list, because the stored list is not a live check.

search_papers

For ArXiv's search_papers, review the permission request and arguments in Claude Code before approval.

download_paper

For ArXiv's download_paper, review the permission request and arguments in Claude Code before approval.

list_papers

For ArXiv's list_papers, review the permission request and arguments in Claude Code before approval.

List the identifiers of papers already downloaded locally.

read_paper

For ArXiv's read_paper, review the permission request and arguments in Claude Code before approval.

Read a saved paper as Markdown, optionally in bounded chunks.

semantic_search

For ArXiv's semantic_search, review the permission request and arguments in Claude Code before approval.

Search downloaded papers by semantic similarity; this feature is experimental.

ArXiv: full stored tool descriptions

Troubleshooting ArXiv in Claude Code

• If ArXiv MCP Server fails to start, check uv, the working directory, and Claude Code's selected scope; inspect claude mcp list and /mcp.
• ArXiv MCP Server uses stdio here: Claude Code must keep the configured process running; protocol output belongs on stdout and diagnostics on stderr.
• Known limitation: PDF-only papers need the additional PDF dependency extra.
• Known limitation: Local semantic search is experimental and requires extra dependencies.
• Known limitation: Untrusted paper text can carry prompt-injection instructions.
• General Claude Code troubleshooting lives in the /clients/claude-code guide.

Frequently asked questions