arXiv Research
About
Search and retrieve academic papers from the arXiv repository via its API.
Details
- Author
- andybrandt
- Repository
- andybrandt/mcp-simple-arxiv
- GitHub stars
- 71
- Downloads
- 76,741
- License
- MIT License
- Categories
- Search, Other
- Tags
- #learning, #education, #research
Jump to
This server allows LLM clients (like Claude Desktop) to:
- Search for scientific papers on arXiv by title and abstract content
- Filter search results by submission date range
- Control search result sorting (by submission date, update date, or relevance)
- See total matching results count to gauge search specificity
- Get paper metadata and abstracts
- Retrieve full paper text as Markdown (converted from PDF)
- Access links to available paper formats (PDF/HTML)
- Browse and search arXiv subject categories
To use the web version just add this connector to Claude.ai https://mcp.andybrandt.net/arxiv .
You can also install & use it locally.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
arXiv ResearchCommand (node, npx, python, etc.)pythonArguments-
Argument 1
-m -
Argument 2
mcp_simple_arxiv
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
This server can be run in two modes: as a local stdio server for desktop clients or as a network-accessible web server.
To install Simple Arxiv for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install mcp-simple-arxiv --client claude
pip install mcp-simple-arxiv
Add this configuration to your claude_desktop_config.json:
(Mac OS)
{
"mcpServers": {
"simple-arxiv": {
"command": "python",
"args": ["-m", "mcp_simple_arxiv"]
}
}
}
(Windows version):
{
"mcpServers": {
"simple-arxiv": {
"command": "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Programs\\Python\\Python311\\python.exe",
"args": [
"-m",
"mcp_simple_arxiv"
]
}
}
}
After restarting Claude Desktop, the following capabilities will be available:
Once you have a paper ID, you can ask for more details:
Can you show me the details for paper 2103.08220?
This will return:
- Full paper title
- Authors
- Publication and update dates
- Journal reference (if available)
- Paper abstract
- Links to available formats (PDF/HTML)
For web deployment see WEB_DEPLOYMENT.md.
search_papers
Search for scientific papers on arXiv by title and abstract content. Parameters: query (string)
filter_search_results
Filter search results by submission date range. Parameters: start_date (string), end_date (string)
sort_search_results
Control search result sorting by submission date, update date, or relevance. Parameters: sort_by (string)
get_total_matching_results
See total matching results count to gauge search specificity.
get_paper_metadata
Get paper metadata and abstracts using the paper ID. Parameters: paper_id (string)
retrieve_full_paper_text
Retrieve full paper text as Markdown (converted from PDF). Parameters: paper_id (string)
access_paper_links
Access links to available paper formats (PDF/HTML) using the paper ID. Parameters: paper_id (string)
browse_arxiv_categories
Browse and search arXiv subject categories.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"arxiv research": {
"env": {},
"args": [
"-m",
"mcp_simple_arxiv"
],
"command": "python"
}
}
}
Linux
{
"env": [],
"args": [
"-m",
"mcp_simple_arxiv"
],
"command": "python"
}
Macos
{
"env": [],
"args": [
"-m",
"mcp_simple_arxiv"
],
"command": "python"
}
Windows
{
"env": [],
"args": [
"-m",
"mcp_simple_arxiv"
],
"command": "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Programs\\Python\\Python311\\python.exe"
}
mcp-simple-arxiv
An MCP server that provides access to arXiv papers through their API.
<a href="https://glama.ai/mcp/servers/p38q3nagwb"></a>
Features
This server allows LLM clients (like Claude Desktop) to:
- Search for scientific papers on arXiv by title and abstract content
- Filter search results by submission date range
- Control search result sorting (by submission date, update date, or relevance)
- See total matching results count to gauge search specificity
- Get paper metadata and abstracts
- Retrieve full paper text as Markdown (converted from PDF)
- Access links to available paper formats (PDF/HTML)
- Browse and search arXiv subject categories
To use the web version just add this connector to Claude.ai https://mcp.andybrandt.net/arxiv .
You can also install & use it locally.
Installation and Deployment
This server can be run in two modes: as a local stdio server for desktop clients or as a network-accessible web server.
Installing via Smithery
To install Simple Arxiv for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install mcp-simple-arxiv --client claude
Manual Installation
pip install mcp-simple-arxiv
Usage with Claude Desktop
Add this configuration to your claude_desktop_config.json:
(Mac OS)
{
"mcpServers": {
"simple-arxiv": {
"command": "python",
"args": ["-m", "mcp_simple_arxiv"]
}
}
}
(Windows version):
{
"mcpServers": {
"simple-arxiv": {
"command": "C:\\Users\\YOUR_USERNAME\\AppData\\Local\\Programs\\Python\\Python311\\python.exe",
"args": [
"-m",
"mcp_simple_arxiv"
]
}
}
}
After restarting Claude Desktop, the following capabilities will be available:
Searching Papers
You can ask Claude to search for papers using queries like:
Can you search arXiv for recent papers about large language models?
The LLM can sort results by submission date, update date, or relevance:
Search arXiv for papers about transformers, sorted by relevance.
Date filtering lets you focus on specific time periods:
Find papers about quantum computing published in 2024.
Search for recent machine learning papers from the last 6 months.
Search results include:
- Total number of matching papers (e.g., "Found 15,234 total results, showing first 10")
- Paper title, authors, and arXiv ID
- Categories (primary and additional)
- Publication date
- Abstract preview
Getting Paper Details
Once you have a paper ID, you can ask for more details:
Can you show me the details for paper 2103.08220?
This will return:
- Full paper title
- Authors
- Publication and update dates
- Journal reference (if available)
- Paper abstract
- Links to available formats (PDF/HTML)
For web deployment see WEB_DEPLOYMENT.md.
Development
To install for development:
git clone https://github.com/andybrandt/mcp-simple-arxiv
cd mcp-simple-arxiv
pip install -e .
arXiv API Guidelines
This server follows arXiv API usage guidelines:
- Rate limiting to max 1 request per 3 seconds
- Single connection at a time
- Proper error handling and retry logic
License
MIT
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.



