Skip to content

trendsmcp/google-trends-mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 

Repository files navigation

google-trends-mcp

Google Trends MCP Works with Claude Works with Cursor

Google Trends data for AI assistants and agents Ask your AI what is trending on Google right now. Get breakout keywords, rising topics, and 5 years of normalized search interest data - without writing a single line of scraping code.

Full docs and live demo: https://trendsmcp.ai/google-trends

Part of Trends MCP -- the MCP server for live trend data across 12+ sources. See the main repo: https://github.com/trendsmcp/trends-mcp


Get started in 2 steps

Step 1: Get your free API key at trendsmcp.ai 100 requests/day, no credit card required.

Step 2: Add to your AI client (replace YOUR_API_KEY):

+ Add to Cursor (one click)

Cursor / Windsurf / Cline   (~/.cursor/mcp.json or equivalent)

{
  "mcpServers": {
    "trends-mcp": {
      "url": "https://api.trendsmcp.ai/mcp",
      "transport": "http",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

VS Code / GitHub Copilot   (.vscode/mcp.json)

{
  "servers": {
    "trends-mcp": {
      "type": "http",
      "url": "https://api.trendsmcp.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

Claude Desktop   (claude_desktop_config.json) User → Settings → Developer → Edit Config — add inside mcpServers

{
  "mcpServers": {
    "trends-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.trendsmcp.ai/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Claude.ai (browser)   Settings -> Connectors -> Add custom connector:

https://api.trendsmcp.ai/mcp

Example query

After connecting, ask your AI:

get_trends(keyword='artificial intelligence', source='google search', data_mode='weekly')

Available tools

Tool What it does
get_trends Time-series for a keyword on this source
get_growth Growth % over 1W, 1M, 3M, 6M, 1Y periods
get_top_trends What is trending right now on this source
get_ranked_trends Top topics ranked by volume

FAQ

What Google Trends data does Trends MCP return?

Trends MCP returns normalized search interest (0-100 scale), absolute search volume estimates, weekly or daily time series, and growth rate over your chosen period. Data reflects real Google Search demand.

How is this different from the official Google Trends website?

Google Trends shows relative interest only. Trends MCP adds absolute volume estimates, structured JSON output your AI can reason over, and cross-platform comparison - so you can compare Google interest against TikTok or Reddit in one query.

Can I get Google Trends data for multiple keywords at once?

Yes. Pass a list of keywords and the MCP server returns normalized series for each, aligned on the same timeline so your AI can compare them directly.

How far back does Google Trends data go?

Up to 5 years of weekly data or 30 days of daily data. Use the period parameter: '5y', '1y', '3m', '1m', or '30d'.

Does it support geographic filtering?

Yes. You can filter by country code (e.g. US, GB, DE) to get region-specific search interest instead of global data.


All data sources

Trends MCP covers 12+ sources in one connection: Google Search, YouTube, TikTok, Reddit, Amazon, Wikipedia, News Sentiment, Web Traffic, App Downloads, Steam, npm, and more.

Browse all: https://trendsmcp.ai/data-sources


License

MIT © Trends MCP

About

MCP server for live Google Trends data. Query search volume, breakout keywords, and 5-year history from Claude, Cursor, VS Code and more.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors