Skip to content
MCP server

Scholar MCP

Federated academic search, citation graphs, PDF download and paper reading for agents

Runs locally
Install
Platforms
CLI, self-hosted, macOS
Runs
Locally
Version
0.11.0
Listing updated
4 days ago

Similar MCP servers

About Scholar MCP

Scholar MCP is an MCP server for web search and scraping. It runs locally on your machine and is started by your AI client.

One question fans out to many scholarly indexes at once, including OpenAlex, Semantic Scholar, arXiv, Crossref, PubMed, Europe PMC, DBLP, CORE and Google Scholar. Duplicates merge on DOI, arXiv id or title, a ranking model orders the pool, and citations of the strongest matches are pulled in before the final ranking.

Beyond search it reads a paper page by page into Markdown with tables and figure images, downloads PDFs from open archives or your institution's library, builds citation graphs with PageRank, and keeps a local SQLite library with notes and tags that can mirror to Obsidian, Zotero or Notion.

The README reports a 62% top-five hit rate on 50 LitSearch queries versus 52% for Exa and 46% for BM25. An installer registers it with 32 agent clients. Several indexes accept optional API keys.

Install

Run in a terminal

claude mcp add scholar-mcp --env S2_API_KEY='<S2_API_KEY>' --env OPENALEX_API_KEY='<OPENALEX_API_KEY>' --env CORE_API_KEY='<CORE_API_KEY>' --env SCOPUS_API_KEY='<SCOPUS_API_KEY>' --env DASHSCOPE_API_KEY='<DASHSCOPE_API_KEY>' --env SCHOLAR_RERANK_API_KEY='<SCHOLAR_RERANK_API_KEY>' --env EXA_API_KEY='<EXA_API_KEY>' --env ZOTERO_API_KEY='<ZOTERO_API_KEY>' --env NOTION_API_KEY='<NOTION_API_KEY>' -- uvx scholar-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "scholar-mcp": {
      "command": "uvx",
      "args": [
        "scholar-mcp"
      ],
      "env": {
        "S2_API_KEY": "<S2_API_KEY>",
        "OPENALEX_API_KEY": "<OPENALEX_API_KEY>",
        "CORE_API_KEY": "<CORE_API_KEY>",
        "SCOPUS_API_KEY": "<SCOPUS_API_KEY>",
        "DASHSCOPE_API_KEY": "<DASHSCOPE_API_KEY>",
        "SCHOLAR_RERANK_API_KEY": "<SCHOLAR_RERANK_API_KEY>",
        "EXA_API_KEY": "<EXA_API_KEY>",
        "ZOTERO_API_KEY": "<ZOTERO_API_KEY>",
        "NOTION_API_KEY": "<NOTION_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "scholar-mcp": {
      "command": "uvx",
      "args": [
        "scholar-mcp"
      ],
      "env": {
        "S2_API_KEY": "<S2_API_KEY>",
        "OPENALEX_API_KEY": "<OPENALEX_API_KEY>",
        "CORE_API_KEY": "<CORE_API_KEY>",
        "SCOPUS_API_KEY": "<SCOPUS_API_KEY>",
        "DASHSCOPE_API_KEY": "<DASHSCOPE_API_KEY>",
        "SCHOLAR_RERANK_API_KEY": "<SCHOLAR_RERANK_API_KEY>",
        "EXA_API_KEY": "<EXA_API_KEY>",
        "ZOTERO_API_KEY": "<ZOTERO_API_KEY>",
        "NOTION_API_KEY": "<NOTION_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "scholar-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "scholar-mcp"
      ],
      "env": {
        "S2_API_KEY": "<S2_API_KEY>",
        "OPENALEX_API_KEY": "<OPENALEX_API_KEY>",
        "CORE_API_KEY": "<CORE_API_KEY>",
        "SCOPUS_API_KEY": "<SCOPUS_API_KEY>",
        "DASHSCOPE_API_KEY": "<DASHSCOPE_API_KEY>",
        "SCHOLAR_RERANK_API_KEY": "<SCHOLAR_RERANK_API_KEY>",
        "EXA_API_KEY": "<EXA_API_KEY>",
        "ZOTERO_API_KEY": "<ZOTERO_API_KEY>",
        "NOTION_API_KEY": "<NOTION_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "scholar-mcp": {
      "command": "uvx",
      "args": [
        "scholar-mcp"
      ],
      "env": {
        "S2_API_KEY": "<S2_API_KEY>",
        "OPENALEX_API_KEY": "<OPENALEX_API_KEY>",
        "CORE_API_KEY": "<CORE_API_KEY>",
        "SCOPUS_API_KEY": "<SCOPUS_API_KEY>",
        "DASHSCOPE_API_KEY": "<DASHSCOPE_API_KEY>",
        "SCHOLAR_RERANK_API_KEY": "<SCHOLAR_RERANK_API_KEY>",
        "EXA_API_KEY": "<EXA_API_KEY>",
        "ZOTERO_API_KEY": "<ZOTERO_API_KEY>",
        "NOTION_API_KEY": "<NOTION_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "scholar-mcp": {
      "command": "uvx",
      "args": [
        "scholar-mcp"
      ],
      "env": {
        "S2_API_KEY": "<S2_API_KEY>",
        "OPENALEX_API_KEY": "<OPENALEX_API_KEY>",
        "CORE_API_KEY": "<CORE_API_KEY>",
        "SCOPUS_API_KEY": "<SCOPUS_API_KEY>",
        "DASHSCOPE_API_KEY": "<DASHSCOPE_API_KEY>",
        "SCHOLAR_RERANK_API_KEY": "<SCHOLAR_RERANK_API_KEY>",
        "EXA_API_KEY": "<EXA_API_KEY>",
        "ZOTERO_API_KEY": "<ZOTERO_API_KEY>",
        "NOTION_API_KEY": "<NOTION_API_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • SCHOLAR_DATA_DIR
  • SCHOLAR_MCP_EXTENSIONS
  • S2_API_KEY
  • OPENALEX_API_KEY
  • CORE_API_KEY
  • SCOPUS_API_KEY
  • DASHSCOPE_API_KEY
  • DASHSCOPE_HTTP_BASE_URLAlibaba workspace API host or /api/v1 base URL.
  • SCHOLAR_RERANK_MODELAlibaba or custom reranker model name.
  • SCHOLAR_RERANK_URLFull custom rerank endpoint; overrides Alibaba routing.
  • SCHOLAR_RERANK_API_KEY
  • EXA_API_KEY
  • ZOTERO_API_KEY
  • ZOTERO_LIBRARY_ID
  • NOTION_API_KEY
  • NOTION_DATA_SOURCE_ID

Tools this server provides (8)

Taken from the project documentation; the running server may differ.

search_papers
Searches all sources, merges duplicates and reranks.
paper_info
Metadata, citations and references of a paper.
recommend_papers
Semantic neighbours and co-cited papers.
search_authors
Author profiles, affiliations and metrics.
read_paper
Page-aware Markdown, tables and figures, read temporarily.
download_paper
Downloads the PDF into your library.
build_paper_graph
Citation graph with PageRank and bridge papers.
paper_library
Collections, notes, tags and full-text search.

What it does

Parallel multi-source search
Queries many indexes at once; a slow source cannot stall the rest.
Citation traversal
Follows citations and related work for the best matches.
Paper reading
Page-aware Markdown with tables and figure images.
Persistent library
SQLite store with notes, tags and full-text search.
PDF download
Fetches open copies or via your library proxy.
One-line installer
Registers itself with supported agent clients.

Good for

  • Survey recent work on a research topic
  • Trace a paper's citations and references
  • Read a paper's tables and figures
  • Build a personal reading library with notes
  • Find the right author behind a common name

Scholar MCP FAQ

Which sources does it search?

The README names OpenAlex, Semantic Scholar, arXiv, Crossref, OpenReview, PubMed, Europe PMC, DBLP, zbMATH, CORE, OpenAIRE and Google Scholar.

Do I need API keys?

Keys for Semantic Scholar, OpenAlex, CORE and Scopus are optional extras.

Where does it store data?

In a local library under ~/.scholar-mcp/.

How was retrieval quality measured?

On the first 50 LitSearch inline-ACL queries, per the README.

How do I add Scholar MCP to Claude Code?

Run this command in your terminal: claude mcp add scholar-mcp --env S2_API_KEY='<S2_API_KEY>' --env OPENALEX_API_KEY='<OPENALEX_API_KEY>' --env CORE_API_KEY='<CORE_API_KEY>' --env SCOPUS_API_KEY='<SCOPUS_API_KEY>' --env DASHSCOPE_API_KEY='<DASHSCOPE_API_KEY>' --env SCHOLAR_RERANK_API_KEY='<SCHOLAR_RERANK_API_KEY>' --env EXA_API_KEY='<EXA_API_KEY>' --env ZOTERO_API_KEY='<ZOTERO_API_KEY>' --env NOTION_API_KEY='<NOTION_API_KEY>' -- uvx scholar-mcp

What are the best alternatives to Scholar MCP?

The closest alternatives to Scholar MCP are Machine Library, Academic Research MCP Server, Cerebrum, arXiv & OpenAlex Academic Search MCP and Papers by Ouroboros Apps.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers