Google Keyword Planner MCP Server
You can research keywords, retrieve historical Google Ads Keyword Planner metrics, forecast paid-search performance, and inspect account/location/language configuration.
Generate keyword ideas from seed keywords, a URL, a site, or keywords plus a URL, with volumes, competition, bid ranges, trends, and optional monthly data.
Filter ideas by minimum search volume and sort by searches, competition, bid, or relevance.
Get historical metrics and trends for up to 10,000 exact keywords, including close variants and missing-data reporting.
Forecast impressions, clicks, cost, CTR, and average CPC for keywords at a max CPC over 1–365 days.
Find Google location IDs by place name.
List targetable languages with codes and IDs.
List accessible Google Ads customer accounts.
Check credentials and view the configured account, API version, currency, and defaults.
Provides access to Google Ads Keyword Planner data, enabling retrieval of keyword ideas from seed keywords, URLs or a whole site, historical search volume and monthly trends for exact keywords, and click/cost forecasts at a given max CPC. Also supports looking up location IDs and targetable languages, listing accessible Google Ads accounts, and verifying credentials and account defaults.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Google Keyword Planner MCP Server Find 100 keyword ideas for online accounting software in Nigeria, sorted by search volume"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Google Keyword Planner MCP server
An MCP server that gives Claude and other MCP clients direct access to Google Ads Keyword Planner data: keyword ideas, average monthly searches, competition, top-of-page bid ranges, monthly trends and click and cost forecasts.
Built by Afeez Adebayo. MIT licensed.
What you can ask
"Find 100 keyword ideas for online accounting software in Nigeria, sorted by search volume."
"Get search volume for these 50 keywords in the UK and US, with their trends."
"Pull keyword ideas from https://example.com/pricing."
"Forecast clicks and cost for these exact-match keywords at a ₦300 max CPC for 30 days."
Related MCP server: Google Ads MCP Server
Tools
Tool | What it does |
| Ideas from seed keywords, a URL, keywords plus a URL, or a whole site. Returns average monthly searches, competition, low and high top-of-page bids, 3-month change, change across the period (first to last month shown), and optional monthly volumes. Filter by minimum volume and sort by searches, competition, bid or relevance. |
| Historical metrics for up to 10,000 exact keywords, with close variants and a list of keywords Google returned no data for. Optional month range. |
| Impressions, clicks, cost, CTR and average CPC for keywords at a given max CPC over 1 to 365 days. |
| Look up Google location IDs by place name. |
| List targetable languages with codes and IDs. |
| List the Google Ads accounts your login can access. |
| Confirm credentials and show the account, currency and defaults. |
Locations and languages accept plain names ("Nigeria", "Lagos", "English") as well as Google IDs. Bids and costs are shown in your Google Ads account currency.
What you need
Keyword Planner data comes from the Google Ads API. Since 9 September 2026, Google no longer uses developer tokens: API access belongs to the Google Cloud project that owns your OAuth client. You need:
A Google Ads account. It must be enabled, but it doesn't need running campaigns. A manager account is optional.
A Google Cloud project with the Google Ads API enabled. In the Google Cloud console, create a project and enable the Google Ads API. This gives Test access, which only works with test accounts.
Basic access for that project. Keyword Planner isn't included in Explorer access, so you need Basic access:
Configure the OAuth consent screen (Google Auth Platform > Branding) and complete brand verification.
Open the Google Ads API Overview page for the project and apply for Basic access. Google reviews it automatically, usually within minutes of brand verification.
If your project is on the Google Cloud free trial, Google may reject the application; upgrading the billing account to a paid tier fixes this (you won't be charged for the Google Ads API).
An OAuth client ID of type Desktop app, in the same project. Set the consent screen's publishing status to In production, because refresh tokens from apps in Testing status expire after 7 days.
A refresh token. Clone this repository and run:
npm install GOOGLE_ADS_CLIENT_ID=your-client-id GOOGLE_ADS_CLIENT_SECRET=your-secret npm run authOpen the printed link, sign in with the Google account that can access your Ads account, and copy the refresh token it prints.
Install
Claude Desktop (one click)
Download google-keyword-planner.mcpb from the latest release and open it. Claude Desktop asks for your credentials and stores the secrets securely.
Any MCP client (from source)
git clone https://github.com/afeezadebayo/google-keyword-planner-mcp.git
cd google-keyword-planner-mcp
npm install && npm run buildThen add it to your client config:
{
"mcpServers": {
"google-keyword-planner": {
"command": "node",
"args": ["/path/to/google-keyword-planner-mcp/server/index.js"],
"env": {
"GOOGLE_ADS_CLIENT_ID": "...",
"GOOGLE_ADS_CLIENT_SECRET": "...",
"GOOGLE_ADS_REFRESH_TOKEN": "...",
"GOOGLE_ADS_CUSTOMER_ID": "123-456-7890",
"GOOGLE_ADS_LOGIN_CUSTOMER_ID": "",
"KEYWORD_PLANNER_DEFAULT_LANGUAGE": "English",
"KEYWORD_PLANNER_DEFAULT_LOCATIONS": "Nigeria"
}
}
}
}For Claude Code:
claude mcp add google-keyword-planner \
-e GOOGLE_ADS_CLIENT_ID=... -e GOOGLE_ADS_CLIENT_SECRET=... \
-e GOOGLE_ADS_REFRESH_TOKEN=... -e GOOGLE_ADS_CUSTOMER_ID=123-456-7890 \
-- node /path/to/google-keyword-planner-mcp/server/index.jsConfiguration
Variable | Required | Notes |
| Yes | OAuth client (Desktop app). Its Cloud project needs Basic access. |
| Yes | |
| Yes | From |
| Yes | The account to query. Dashes are fine. |
| No | Your manager account ID, if you access the account through one. |
| No | Defaults to |
| No | Used when a request doesn't name a language. |
| No | Comma-separated names or IDs used when a request doesn't name locations. |
| No | Legacy. Google retired developer tokens on 9 September 2026; it's only sent if you set it. |
Good to know
Volumes are estimates. Keyword Planner rounds search volumes into ranges and groups close variants. Accounts with little or no ad spend may see broader ranges.
Rate limits. Keyword Planner allows a limited number of requests per minute. The server retries rate-limit and server errors automatically with back-off.
Errors explain the fix. Common problems (a Cloud project with only Test access, a missing manager account ID, an expired refresh token) come back with a plain-English explanation of how to fix them.
Privacy. The server runs on your machine and talks only to Google. Credentials stay in your MCP client's config.
Development
npm install
npm run typecheck
npm run build
npm test # runs every tool against a local mock of the Google Ads APIReleases are automated: bumping version in package.json and pushing to main builds the bundle, creates a GitHub release and publishes the listing to the official MCP Registry.
Available Tools
7 toolscheck_connectionCheck connectionARead-onlyIdempotent
Check that credentials work and show the configured account, API version, currency and defaults.
Inputs: no named parameters.
find_locationsFind location IDsARead-onlyIdempotent
Search Google's geo targets by name to get location IDs for countries, regions, cities and more.
Inputs: names (required), locale, country_code.
forecast_keywordsForecast clicks and costARead-onlyIdempotent
Forecast impressions, clicks, cost, CTR and average CPC for a set of keywords over a future period, using Keyword Planner's forecasting. Useful for budgeting a paid search campaign.
Inputs: max_cpc (required), keywords (required), days, network, +2 more.
generate_keyword_ideasGenerate keyword ideasARead-onlyIdempotent
Get keyword ideas from Keyword Planner using seed keywords, a page URL, a whole site, or keywords plus a URL. Returns each idea's average monthly searches, competition, top-of-page bid range, 3-month change, change across the period (first to last month), and monthly volumes.
Inputs: url, site, limit, network, +7 more.
get_search_volumeGet search volume and metricsARead-onlyIdempotent
Get historical Keyword Planner metrics for specific keywords: average monthly searches, monthly volumes, competition, top-of-page bid range and trends. Use this to check exact keywords rather than discover new ones. Close variants that Google groups together are listed.
Inputs: keywords (required), network, language, end_month, +3 more.
list_accessible_customersList Google Ads accountsARead-onlyIdempotent
List the Google Ads customer IDs the signed-in user can access. Use it to find the right GOOGLE_ADS_CUSTOMER_ID.
Inputs: no named parameters.
list_languagesList languagesARead-onlyIdempotent
List the languages Keyword Planner can target, with their codes and IDs.
Inputs: filter.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool targets a distinct capability: connectivity check, keyword discovery, exact-metric lookup, forecasting, geo lookup, language listing, and account listing. The only potential overlap is generate_keyword_ideas vs get_search_volume, but the descriptions explicitly frame one as discovery and the other as exact-keyword verification, so an agent can reliably choose.
All seven names use consistent snake_case verb_noun structure (check_connection, generate_keyword_ideas, get_search_volume, forecast_keywords, find_locations, list_languages, list_accessible_customers). The verbs are descriptive and predictable throughout.
Seven tools is well-scoped for a Keyword Planner integration, covering auth/config, discovery, metrics, forecasting, and the lookup helpers needed to use the main tools. No tool feels redundant or padded.
The surface covers the core Keyword Planner lifecycle: keyword discovery, exact metrics, forecasting, geo targeting, language targeting, and customer-ID discovery plus a connectivity check. Minor gaps exist, such as no tool for browsing keyword categories or filtering ideas by category/network settings, but core workflows are not blocked.
Maintenance
Related MCP Connectors
Real SEO data for AI assistants: page audits, Keyword Planner volumes, Search Console history.
SEO & marketing toolkit for AI agents: GA4, Search Console, AdSense, GTM, PageSpeed, Trends.
Google keyword search volume, CPC, difficulty, intent and keyword ideas. Runs on Apify.
Keyword ideas from Google Autocomplete plus Google Trends interest and rising queries. No API key.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides SEO automation with tools for keyword research, SERP analysis, and competitor analysis through Google Ads API integration, enabling AI assistants to access these capabilities via MCP.50ISC
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Google Ads through secure OAuth authentication to discover keyword ideas, analyze historical search metrics, and generate forecasts for advertising campaigns. Built as a Next.js application with encrypted credential storage and rate limiting.1Apache 2.0
- AlicenseBqualityCmaintenanceEnables comprehensive Google Ads campaign management and analysis through natural language, including performance metrics, keyword optimization, budget management, and custom GAQL queries.10017MIT
- AlicenseAqualityBmaintenanceEnables reading and analyzing Google Ads data, planning keywords, and previewing campaign changes before applying them, all through natural language.35440 npm1Apache 2.0