arxiv-mcp-server
A local MCP server for arXiv literature work: section-level paper reads, BibTeX from metadata, topic watches
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
Install
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/arxiv-mcp-serverDetects 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.2Or 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.
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.
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.2Or 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.2Or 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.
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-serverDefault 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 BibTeXLimitations
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.
Related
Microsoft's utility and MCP server that turn PDF, Word, Excel, PowerPoint, HTML and other files into Markdown for models
Anthropic skills
Skills
Anthropic's official skill examples: docx, pdf, pptx and xlsx documents, design, MCP builder and the Agent Skills spec
A skill that builds editable PPTX decks from PDF, DOCX, URLs and Markdown with native shapes, charts and animations
A skill that draws editorial diagrams as standalone HTML and SVG files: architecture, flowcharts, ER, funnels and about forty more types