Scholar MCP

Name: Scholar MCP
Author: Liyux3

Liyux3

Searches OpenAlex, Semantic Scholar, arXiv, PubMed and other academic sources through one interface, with citation graphs, PDFs and a local paper library.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add scholar --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>' -- uvx scholar-mcp

~/.codex/config.toml

[mcp_servers.scholar]
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>" }

# codex mcp add scholar --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>' -- uvx scholar-mcp

~/.cursor/mcp.json

{
  "mcpServers": {
    "scholar": {
      "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>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "scholar": {
      "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>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "scholar": {
      "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>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "scholar": {
      "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>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "scholar": {
      "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>"
      }
    }
  }
}

Environment variables

S2_API_KEY
OPENALEX_API_KEY
CORE_API_KEY
SCOPUS_API_KEY
DASHSCOPE_API_KEY
SCHOLAR_RERANK_API_KEY
EXA_API_KEY
ZOTERO_API_KEY

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related