Google Scholar MCP

An MCP (Model Context Protocol) server for searching Google Scholar, built for AI assistants and automation workflows that need papers, authors, citations, and BibTeX entries.
- Features
- Installation
- Configuration
- Usage
- Examples
- Rate Limiting
- Troubleshooting
- Contributing

- Python 3.11or later
- Dependencies:mcp[cli]>=1.4.0,scholarly>=1.7.11,pydantic>=2.0(seepyproject.toml)

git clone https://github.com/LWaetzig/google-scholar-search-mcp.git cd google-scholar-search-mcp pip install -e .

Note:This server uses thescholarlylibrary to access Google Scholar. Respect Google's Terms of Service and use rate limiting appropriately to avoid being blocked.

export GS_PROXY_TYPE=single export GS_PROXY_HTTP=http://proxy.example.com:8080 export GS_PROXY_HTTPS=https://proxy.example.com:8080

export GS_PROXY_TYPE=scraperapi export GS_SCRAPERAPI_KEY=your_key_here

Detailed documentation about single tools can be foundhere

{ "mcpServers": { "google-scholar": { "command": "python", "args": ["-m", "google_scholar_mcp.server"], "env": { "GS_MIN_DELAY": "5.0", "GS_MAX_DELAY": "15.0", "GS_PROXY_TYPE": "none" } } } }

After updating the config, restart Claude Desktop. The Google Scholar tools will appear in the MCP Tools panel.

Any MCP client (e.g., Cline, Continue, or custom tools) can use this server. Configure the connection to:

Command: python -m google_scholar_mcp.server Transport: stdio

The server automatically enforces rate limiting between requests to avoid overloading Google Scholar's servers:

- Min Delay(default 5s): Minimum wait between consecutive requests
- Max Delay(default 15s): Maximum wait (randomized to avoid patterns)
- Max Retries(default 3): Retry failed requests up to this many times

These settings help prevent being blocked by Google Scholar. Adjust via environment variables if needed:

export GS_MIN_DELAY=3.0 export GS_MAX_DELAY=10.0 export GS_MAX_RETRIES=5

If you exceed Google Scholar's rate limits despite the rate limiter:

- Your IP may be temporarily blocked(usually 24-48 hours)
- All requests will failwith connection errors or 429 responses
- Blocked IPs cannot make requestseven with valid proxies on the same IP range
- Repeated violations may trigger permanent blocksor require CAPTCHA solving
- Never decrease delays below 5 seconds— the defaults are tuned for reliability
- Use the bulk_search toolinstead of rapid sequential searches — it includes built-in delays
- Add extra buffer during bulk operations— consider settingGS_MIN_DELAY=10.0for large jobs
- Use a proxy service(free proxy or ScraperAPI) to distribute requests across multiple IPs
- Monitor for 429 errors— if you see them, increase delays immediately and wait before retrying
- Spread requests over time— don't run 100 queries in 5 minutes, even with delays

- Wait 24-48 hoursfor the temporary block to expire
- Use a proxy— enableGS_PROXY_TYPE=freeorscraperapito route through different IPs
- Change your network— use a different WiFi/ISP temporarily if possible
- Contact support— for persistent blocks, escalate to Google Scholar support

"Error: 429 Too Many Requests"

You've hit Google Scholar's rate limit. Solutions:
- Increase delays:Set higherGS_MIN_DELAYandGS_MAX_DELAY
- Use a proxy:SetGS_PROXY_TYPE=freeor use ScraperAPI
- Wait and retry:Google Scholar may be temporarily blocking; try again later

- Check your query syntax (Google Scholar supports advanced search operators)
- Ensure the author/paper name is spelled correctly
- Try a simpler query with fewer keywords

- IncreaseGS_TIMEOUTif your network is slow
- Check your internet connection
- Verify proxy settings if using a proxy
- Fork the repository
- Create a feature branch (git checkout -b feature/your-feature)
- Commit your changes with clear messages
- Push to your fork
- Open a pull request

For issues, questions, or feature requests, please open an issue on GitHub.

Search global news using natural language. Webz.io News Search API returns the most relevant articles and content, with filters for source, country, language, date, sentiment, and category.

Harvests scientific papers from arXiv and OpenAlex, providing real-time access to metadata and full text.

Search for scientific publications across ArXiv, ACL Anthology, HuggingFace Datasets, and Semantic Scholar.

Research papers from arXiv, Google Scholar, and Wikipedia with citation metrics

A flexible service for searching and analyzing academic papers on arXiv.

Search scientific papers from any MCP tool. Raw experimental data from full-text papers — methods, results, quality scores. 50 free searches, then $0.01/result.

Search and access academic paper metadata from Crossref.

Query Erick Wendel's contributions, including talks, blog posts, and videos, using natural language.

Model Context Protocol server for searchable, citation-safe hadith text.

Search and cite exact passages across complete classical and world-literature corpora.

Anonymous, read-only, source-backed Buddhist scripture search, passage guidance, explanation, and one-time practice planning through four production MCP tools.