Google Keyword Planner MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GOOGLE_ADS_CLIENT_ID | Yes | Google Cloud OAuth client ID (Desktop app). | |
| GOOGLE_ADS_API_VERSION | No | Google Ads API version. Defaults to `v25`. | |
| GOOGLE_ADS_CUSTOMER_ID | Yes | The Google Ads account to query. Dashes are fine. | |
| GOOGLE_ADS_CLIENT_SECRET | Yes | Google Cloud OAuth client secret. | |
| GOOGLE_ADS_REFRESH_TOKEN | Yes | OAuth refresh token obtained from `npm run auth`. | |
| GOOGLE_ADS_DEVELOPER_TOKEN | Yes | Google Ads developer token. Basic access or higher is required for real data. | |
| GOOGLE_ADS_LOGIN_CUSTOMER_ID | No | Your manager account ID, if you access the account through one. | |
| KEYWORD_PLANNER_DEFAULT_LANGUAGE | No | Used when a request doesn't name a language. | |
| KEYWORD_PLANNER_DEFAULT_LOCATIONS | No | Comma-separated names or IDs used when a request doesn't name locations. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| generate_keyword_ideasA | 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. |
| get_search_volumeA | 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. |
| forecast_keywordsA | 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. |
| find_locationsA | Search Google's geo targets by name to get location IDs for countries, regions, cities and more. |
| list_languagesA | List the languages Keyword Planner can target, with their codes and IDs. |
| list_accessible_customersA | List the Google Ads customer IDs the signed-in user can access. Use it to find the right GOOGLE_ADS_CUSTOMER_ID. |
| check_connectionA | Check that credentials work and show the configured account, API version, currency and defaults. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
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.