arxiv-mcp-server

A local MCP server for arXiv literature work: section-level paper reads, BibTeX from metadata, topic watches

MCP server

Medium risk

We rate an entry medium when the tool runs code, makes network calls or reads project files. Check what exactly it does before installing.

Why this level

  • Runs a local server and makes network calls to arXiv services
  • Downloads and stores paper files on disk
All reasons and checks

blazickjp/arxiv-mcp-server

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/arxiv-mcp-server

Detects the agents on your machine, checks the risk and pins the version.

Other ways to install

Run in a terminal

claude mcp add --transport stdio arxiv-mcp-server -- uvx arxiv-mcp-server==0.7.2

Or add to the file .mcp.json, in the project

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

If the file already exists, add the server inside the mcpServers key.

Keys and settings

ARXIV_STORAGE_PATHoptional
Optional path for storing downloaded papers locally.

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Install in Cursor

The button opens the agent and offers to add the server. If nothing happens, copy the config below.

Add to the file ~/.cursor/mcp.json, for all projects

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

If the file already exists, add the server inside the mcpServers key. For a single project, put the same block into .cursor/mcp.json.

Keys and settings

ARXIV_STORAGE_PATHoptional
Optional path for storing downloaded papers locally.

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Install in VS Code

The button opens the agent and offers to add the server. If nothing happens, copy the config below.

Run in a terminal

code --add-mcp '{"name":"arxiv-mcp-server","type":"stdio","command":"uvx","args":["arxiv-mcp-server==0.7.2"]}'

Or add to the file .vscode/mcp.json, in the project

{
  "servers": {
    "arxiv-mcp-server": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "arxiv-mcp-server==0.7.2"
      ]
    }
  }
}

If the file already exists, add the server inside the servers key.

Keys and settings

ARXIV_STORAGE_PATHoptional
Optional path for storing downloaded papers locally.

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

codex mcp add arxiv-mcp-server -- uvx arxiv-mcp-server==0.7.2

Or add to the file ~/.codex/config.toml, for all projects

[mcp_servers.arxiv-mcp-server]
command = "uvx"
args = ["arxiv-mcp-server==0.7.2"]

If the file already exists, append the block to the end.

Keys and settings

ARXIV_STORAGE_PATHoptional
Optional path for storing downloaded papers locally.

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

gemini mcp add -s user arxiv-mcp-server uvx arxiv-mcp-server==0.7.2

Or add to the file ~/.gemini/settings.json, for all projects

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

If the file already exists, add the server inside the mcpServers key.

Keys and settings

ARXIV_STORAGE_PATHoptional
Optional path for storing downloaded papers locally.

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/devin/mcp_config.json, for all projects

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

If the file already exists, add the server inside the mcpServers key. Legacy Cascade keeps the MCP config in ~/.codeium/windsurf/mcp_config.json.

Keys and settings

ARXIV_STORAGE_PATHoptional
Optional path for storing downloaded papers locally.

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Formerly Windsurf.

Add to the file cline_mcp_settings.json, for all projects

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

If the file already exists, add the server inside the mcpServers key. Open the settings file in Cline: MCP Servers tab, Configure MCP Servers.

Keys and settings

ARXIV_STORAGE_PATHoptional
Optional path for storing downloaded papers locally.

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .roo/mcp.json, in the project

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

If the file already exists, add the server inside the mcpServers key.

Keys and settings

ARXIV_STORAGE_PATHoptional
Optional path for storing downloaded papers locally.

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

A fork of Roo Code, same .roo folders.

Add to the file opencode.json, in the project

{
  "mcp": {
    "arxiv-mcp-server": {
      "type": "local",
      "command": [
        "uvx",
        "arxiv-mcp-server==0.7.2"
      ]
    }
  }
}

If the file already exists, add the server inside the mcp key.

Keys and settings

ARXIV_STORAGE_PATHoptional
Optional path for storing downloaded papers locally.

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/zed/settings.json, for all projects

{
  "context_servers": {
    "arxiv-mcp-server": {
      "command": "uvx",
      "args": [
        "arxiv-mcp-server==0.7.2"
      ]
    }
  }
}

If the file already exists, add the server inside the context_servers key.

Keys and settings

ARXIV_STORAGE_PATHoptional
Optional path for storing downloaded papers locally.

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .codeassistant/mcp.json, in the project

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

If the file already exists, add the server inside the mcpServers key.

Keys and settings

ARXIV_STORAGE_PATHoptional
Optional path for storing downloaded papers locally.

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

You will need: uv

Checked against the repository on Sep 24, 2026, commit 42419c1.

Text for your agent

Install uv, then add the server: claude mcp add --transport stdio --scope user arxiv -- uvx arxiv-mcp-server. For Codex: codex mcp add arxiv -- uvx arxiv-mcp-server.

Other ways from the author
uvx arxiv-mcp-server

Default install. Requires uv, which provides uvx. No repository clone needed.

This is third-party code. Review the repository files before installing.

What it does

The server gives the agent a literature loop over arXiv: search for a paper, download it, read the author-submitted LaTeX one section at a time, export BibTeX from arXiv metadata and keep watches on chosen topics. Downloaded papers stay on disk, by default in ~/.arxiv-mcp-server/papers, with a configurable path. The main flow runs paper ID, outline, one section, citations, and search is optional. The server runs locally over the stdio transport and connects to Claude Code, Codex, Claude Desktop, Cursor, VS Code and other clients through standard MCP configuration. An extended mode adds semantic search over downloaded papers, and a plugin build installs the MCP connection together with a companion arXiv research skill.

Who it is for. For researchers, analysts and authors who work with arXiv preprints regularly inside an agent.

Good fit when

  • You need to read an arXiv paper section by section rather than whole
  • You need BibTeX from arXiv metadata for a bibliography
  • You need to keep papers locally and watch for new work on a topic

Not a fit when

  • You need sources outside arXiv from other databases
  • A plain web search is enough and you do not need local paper storage

Example request

Find an arXiv paper on this topic, read the methods section and export its BibTeX

Limitations

The server works with arXiv preprints and does not cover other databases. It needs uv, which provides the uvx command, and CPython 3.11 or newer. Search, download and citation work reach external services; what stays local is the reading and storage loop. Semantic search is an extra mode with separate dependencies. An unrelated npm package shares the name, so install only the PyPI package.

How to disable. Remove the server entry from the client's MCP configuration, for example claude mcp remove arxiv. If installed as a plugin, remove it via /plugin.

MCP

Transport
stdio
Authentication
not required

Security check

  • Runs a local server and makes network calls to arXiv services
  • Downloads and stores paper files on disk

README in short

The README presents a local MCP server for agent work with arXiv literature and sets it apart from a plain search wrapper: the focus is section-level reads of author LaTeX, BibTeX from authoritative metadata and on-disk topic watches. The default install is uvx arxiv-mcp-server and needs uv, with no repository clone required. It gives ready recipes for Claude Code, Codex, Hermes, VS Code, Kiro and Claude Desktop, plus an stdio configuration in the mcpServers shape. The package is on PyPI and the server is listed in the official MCP registry. It warns separately about an unrelated npm package of the same name. Apache-2.0 licensed.

FAQ

Do I need an API key?

No. The server works with public arXiv data; no keys or authorization are needed.

Why not install via npm?

npm has an unrelated package with the same name. Use the PyPI package arxiv-mcp-server, run through uvx.

Official

Microsoft's utility and MCP server that turn PDF, Word, Excel, PowerPoint, HTML and other files into Markdown for models

MCP serverMedium riskNo VPN needed187.4KRepository stars
Editors’ pick

Anthropic's official skill examples: docx, pdf, pptx and xlsx documents, design, MCP builder and the Agent Skills spec

SkillMedium risk178.8KRepository stars
Editors’ pick

A skill that builds editable PPTX decks from PDF, DOCX, URLs and Markdown with native shapes, charts and animations

SkillMedium risk56.8KRepository stars
Editors’ pick

A skill that draws editorial diagrams as standalone HTML and SVG files: architecture, flowcharts, ER, funnels and about forty more types

SkillMedium riskNo VPN needed42.6KRepository stars
Foxx AIarxiv-mcp-server

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.