Paper Distill MCP server
io.github.Eclipse-Cj/paper-distill-mcp·v0.2.4·67 starsAcademic paper search across 11 sources with AI curation, ranked push, Zotero and Obsidian support.
67 stars36 downloads/wk
Reviews
Write oneNobody has reviewed Paper Distill MCP yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Paper Distill MCP tools (19, 3 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
add_topicAdd a research topic for paper search.
collectCollect pushed papers to Zotero and optionally create Obsidian notes.
collect_to_zoteroAdd papers to Zotero library by their IDs/DOIs.
configurewrite actionUpdate pipeline configuration.
filter_duplicateswrite actionRemove papers already pushed (by DOI match against papers.jsonl).
finalize_reviewProcess AI review decisions, update pool, and generate push output.
generate_digestGenerate all daily output files (pushes.jsonl, papers.jsonl, Astro site JSON, Obsidian notes).
ingest_research_contextIngest research context from other AI conversations for cross-AI context inheritance.
init_sessionInitialize a research session. Call this first to set up push channels and load context.
load_session_contextLoad previous research context into current session.
manage_topicsManage research topic preferences.
pool_refreshRefresh the paper search pool by querying 9 academic APIs.
pool_statusShow current pool status: paper counts by status, scan day, topics searched.
prepare_reviewPrepare the review prompt for today's scan batch.
prepare_summarizeGenerate a summarization prompt for unsummarized papers in today's batch.
rank_papersScore and rank papers using 4-factor weighted formula.
search_papersSearch academic papers across 9 sources (OpenAlex, Semantic Scholar, PubMed, arXiv, Papers with Code, CrossRef, Europe PMC, bioRxiv, DBLP).
send_pushwrite actionFormat and send daily paper distill to a messaging platform.
setupCheck setup status and guide first-time configuration.
Public scan report
scanner v0.1.10 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan41 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 187 days ago4/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Paper Distill MCP compares
Against every graded Productivity MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 66/100
- higher than 18% of 1,299 Productivity servers
- Tools
- 19
- the typical Productivity server has 7
- Tools that change things
- 16%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 67
- more than 90% of 854 Productivity servers
- Downloads a week
- 36
- more than 23% of 427 Productivity servers with a package
What its tools let an agent do: 13 read · 2 create · 3 change · 1 send or post
Install Paper Distill MCP in Claude Code, Cursor or VS Code
claude mcp add paper-distill-mcp -- uvx paper-distill-mcp
What the publisher says
From the Paper Distill MCP repository's README, as published. We do not edit it. Read it on GitHub
📚 Paper Distill MCP Server
<!-- mcp-name: io.github.Eclipse-Cj/paper-distill-mcp -->
Academic paper search, intelligent curation, and multi-platform delivery — built on the Model Context Protocol.
Compatible with all MCP clients: Claude Desktop, Claude Code, Cursor, Trae, Codex CLI, Gemini CLI, OpenClaw, VS Code, Zed, and more.
⚠️ Early development stage. Many features are still being validated and may contain bugs or instabilities. Feedback and bug reports are warmly welcome!
✨ Features
- 🔍 11-source parallel search — OpenAlex, Semantic Scholar, PubMed, arXiv, Papers with Code, CrossRef, Europe PMC, bioRxiv, DBLP, CORE, Unpaywall
- 🤖 Adaptive AI delivery — the agent tracks your evolving research interests and automatically refines search keywords and recommendations over time
- 📊 4-dimensional weighted ranking — relevance × recency × impact × novelty, fully customizable weights
- 👥 Dual-AI blind review — two AI reviewers independently shortlist papers; a chief reviewer synthesizes a final push/overflow/discard decision (optional)
- 🧹 Scraper delegation — offload abstract extraction to a low-cost agent or API to cut token spend significantly
- 🌐 Personal paper library site — Astro + Vercel auto-deploy; site updates within 30 seconds of each push
- 📬 Multi-platform delivery — Telegram / Discord / Feishu / WeCom
- 📦 Zotero integration — save papers to Zotero with one command
- 📝 Obsidian integration — auto-generate paper note cards with Zotero backlinks; supports summary and template modes
🚀 Quick Install
uvx paper-distill-mcpThat's it. Your AI client will discover all tools automatically. No API keys required for basic paper search.
No uv? → curl -LsSf https://astral.sh/uv/install.sh | sh or brew install uv
Other installation methods (pip / Homebrew / Docker / source)
pip:
pip install paper-distill-mcpHomebrew:
brew tap Eclipse-Cj/tap
brew install paper-distill-mcpDocker:
docker run -i --rm ghcr.io/eclipse-cj/paper-distill-mcpFrom source (developers):
git clone https://github.com/Eclipse-Cj/paper-distill-mcp.git
cd paper-distill-mcp
python3 -m venv .venv && .venv/bin/pip install --upgrade pip && .venv/bin/pip install -e .🔗 Connecting to AI Clients
Claude Desktop
Add to claudedesktopconfig.json (Settings → Developer → Edit Config):
{
"mcpServers": {
"paper-distill": {
"command": "uvx",
"args": ["paper-distill-mcp"]
}
}
}Claude Code
claude mcp add paper-distill -- uvx paper-distill-mcpOr add to .mcp.json:
{
"mcpServers": {
"paper-distill": {
"command": "uvx",
"args": ["paper-distill-mcp"]
}
}
}Codex CLI (OpenAI)
Add to ~/.codex/config.toml:
[mcp_servers.paper-distill]
command = "uvx"
args = ["paper-distill-mcp"]Gemini CLI (Google)
Add to ~/.gemini/settings.json:
{
"mcpServers": {
"paper-distill": {
"command": "uvx",
"args": ["paper-distill-mcp"]
}
}
}OpenClaw
mcporter config add paper-distill --command uvx --scope home -- paper-distill-mcp
mcporter list # verifyTo remove: mcporter config remove paper-distill
OpenClaw — install from source
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Paper Distill MCP: common questions
- Is Paper Distill MCP server safe?
- With care: it is graded C, so read the findings first (66/100). Read the Paper Distill MCP safety report
- How do I install Paper Distill MCP?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Paper Distill MCP need an API key?
- Yes. The registry entry asks for
CORE_API_KEY,TELEGRAM_BOT_TOKEN,DISCORD_WEBHOOK_URL,ZOTERO_API_KEY. - Is Paper Distill MCP maintained?
- The last commit was 225 days ago (2026-03-24). The latest release is v0.2.4.
- What can I use instead of Paper Distill MCP?
- Servers from other publishers that do the same job: DocsAgent — Zotero, Obsidian & Apple Notes MCP Server, Research Hub MCP server and Obsidian Vault MCP server.
- How does Paper Distill MCP compare with other Productivity MCP servers?
- safety score 66/100 (higher than 18% of 1,299 Productivity servers); tools 19 (the typical Productivity server has 7); tools that change things 16% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Paper Distill MCP
Same job from other publishers: the closest match first, then the best rated.
- DocsAgent — Zotero, Obsidian & Apple Notes MCP ServerInstant, private access to your knowledge base: Zotero, Obsidian, Apple Notes (macOS).not reviewedEstablishedB
- Research HubResearch workspace for Zotero + Obsidian + NotebookLM. Search, ingest, sync, verify briefs.not reviewedGrowingA
- Obsidian Vault MCPLocal Zotero, MinerU, Obsidian literature workflow with transactional Analysis notes.not reviewedGrowingA
- ObsidianMCP server that interacts with Obsidian via the Obsidian rest API community pluginnot reviewedEstablishedA
- ObsidianRead, write, search, and surgically edit Obsidian notes, tags, and frontmatter via MCP.not reviewedEstablishedA