---
title: "Google Keyword Planner via MCP: how I wired it into Claude"
description: "A hands-on account of wiring Google Keyword Planner into an AI assistant over MCP: install, OAuth, the new Google access rules and the traps I hit."
url: "https://www.it-deweloper.pl/en/blog/keyword-planner-mcp-setup"
date: "2026-10-25T08:50:16+00:00"
language: "en-GB"
---
[Skip to main content](#tm-main)
- [ Home](https://www.it-deweloper.pl/en "IT Deweloper web studio home page")
- [Contact](https://www.it-deweloper.pl/en/contact "Contact the IT Deweloper web studio")
- [ +48 731 190 041](tel:+48731190041 "Phone")
- [ office@it-deweloper.pl](mailto:office@it-deweloper.pl "E-mail")
- [ Nowogródzka 4A, Białystok, Poland](https://maps.app.goo.gl/BNjvryytwRyv4omA7 "Address")
- [ WhatsApp](https://wa.me/48731190041 "WhatsApp")
- [ Telegram](https://t.me/+48731190041 "Telegram")
- [Solutions](https://www.it-deweloper.pl/en/web "IT Deweloper's web development solutions")
- [How we workStages of work](https://www.it-deweloper.pl/en/web/process "Website development stages and timelines")
- [SEOSearch engine optimization](https://www.it-deweloper.pl/en/web/seo "SEO promotion: optimization, links, positions in Google")
- [GEOWebsite promotion in AI](https://www.it-deweloper.pl/en/web/geo "GEO optimization: website promotion in ChatGPT, Gemini and Perplexity answers")
- [AIArtificial intelligence on the website](https://www.it-deweloper.pl/en/web/ai)
- [JoomlaWebsite management system](https://www.it-deweloper.pl/en/web/joomla "Joomla website development")
- [GoogleGoogle services setup](https://www.it-deweloper.pl/en/web/google "Google services setup for your website")
- [Cost](https://www.it-deweloper.pl/en/cost "Rates and cost of services")
- [PricingIndicative website development prices](https://www.it-deweloper.pl/en/cost/pricing "Website development prices")
- [CalculatorSelf-service online estimate](https://www.it-deweloper.pl/en/cost/calculator "Calculate your website cost online")
- [BriefGet an accurate project quote](https://www.it-deweloper.pl/en/cost/brief "Fill out the website development brief")
- [Portfolio](https://www.it-deweloper.pl/en/portfolio "Portfolio and examples of our work")
- [About us](https://www.it-deweloper.pl/en/about "About the founder — Victor Parhimchik")
- [FAQ](https://www.it-deweloper.pl/en/faq "Frequently asked questions about website development")
- [Blog](https://www.it-deweloper.pl/en/blog "Articles on website development and promotion")
- [ Русский ](https://www.it-deweloper.pl/ru/blog/keyword-planner-mcp-setup)
- [ Polski ](https://www.it-deweloper.pl/pl/blog/keyword-planner-mcp-setup)
- [ Беларуская ](https://www.it-deweloper.pl/be/blog/keyword-planner-mcp-setup)
- [ English ](https://www.it-deweloper.pl/en/blog/keyword-planner-mcp-setup)
-  English
- [ Русский ](https://www.it-deweloper.pl/ru/blog/keyword-planner-mcp-setup)
- [ Polski ](https://www.it-deweloper.pl/pl/blog/keyword-planner-mcp-setup)
- [ Беларуская ](https://www.it-deweloper.pl/be/blog/keyword-planner-mcp-setup)
- [ English ](https://www.it-deweloper.pl/en/blog/keyword-planner-mcp-setup)
[ ](https://www.it-deweloper.pl/en) [ Menu
](#tm-dialog)
- [ Home](https://www.it-deweloper.pl/en "IT Deweloper web studio home page")
- [Contact](https://www.it-deweloper.pl/en/contact "Contact the IT Deweloper web studio")
- [ +48 731 190 041](tel:+48731190041 "Phone")
- [ office@it-deweloper.pl](mailto:office@it-deweloper.pl "E-mail")
- [ Nowogródzka 4A, Białystok, Poland](https://maps.app.goo.gl/BNjvryytwRyv4omA7 "Address")
- [ WhatsApp](https://wa.me/48731190041 "WhatsApp")
- [ Telegram](https://t.me/+48731190041 "Telegram")
- [Solutions](https://www.it-deweloper.pl/en/web "IT Deweloper's web development solutions")
- [How we workStages of work](https://www.it-deweloper.pl/en/web/process "Website development stages and timelines")
- [SEOSearch engine optimization](https://www.it-deweloper.pl/en/web/seo "SEO promotion: optimization, links, positions in Google")
- [GEOWebsite promotion in AI](https://www.it-deweloper.pl/en/web/geo "GEO optimization: website promotion in ChatGPT, Gemini and Perplexity answers")
- [AIArtificial intelligence on the website](https://www.it-deweloper.pl/en/web/ai)
- [JoomlaWebsite management system](https://www.it-deweloper.pl/en/web/joomla "Joomla website development")
- [GoogleGoogle services setup](https://www.it-deweloper.pl/en/web/google "Google services setup for your website")
- [Cost](https://www.it-deweloper.pl/en/cost "Rates and cost of services")
- [PricingIndicative website development prices](https://www.it-deweloper.pl/en/cost/pricing "Website development prices")
- [CalculatorSelf-service online estimate](https://www.it-deweloper.pl/en/cost/calculator "Calculate your website cost online")
- [BriefGet an accurate project quote](https://www.it-deweloper.pl/en/cost/brief "Fill out the website development brief")
- [Portfolio](https://www.it-deweloper.pl/en/portfolio "Portfolio and examples of our work")
- [About us](https://www.it-deweloper.pl/en/about "About the founder — Victor Parhimchik")
- [FAQ](https://www.it-deweloper.pl/en/faq "Frequently asked questions about website development")
- [Blog](https://www.it-deweloper.pl/en/blog "Articles on website development and promotion")
[ IT Deweloper Blog ](https://www.it-deweloper.pl/index.php?option=com_content&view=category&id=29&lang=en-GB "IT Deweloper Blog")
# Google Keyword Planner via MCP: how I wired it into Claude
In September 2026 I wired Google Keyword Planner into Claude over MCP: choosing a server, OAuth, registering the tool — and a 403 caused by Google's new access rules.
---
## What the planner gives you, and why it belongs in a chat
Keyword Planner is a standard Google Ads tool: from a few seed phrases it returns related queries, the average monthly search volume for the past year, the level of advertising competition and a bid range per click, plus a forecast of impressions and clicks for a given budget. This is first-party data — the same numbers Google works from.
The data was never the problem; the routine was. To test one idea for a page you open the panel, pick a region and language, type the seeds, filter out the noise and export a table — all for a single answer: is this text worth writing at all. If the assistant already helps with the copy, demand checking may as well live in the same window.
MCP (Model Context Protocol) is the open protocol an assistant uses to call external tools. I unpacked it in the piece on [connecting Search Console](https://www.it-deweloper.pl/en/blog/google-search-console-mcp). Here one sentence is enough: an MCP server is a small go-between program on your machine that answers the assistant on one side and calls Google's API on the other.
## Which server I picked
There were three kinds of options. Google's own MCP server for the Ads API is general purpose — account queries, metadata, arbitrary reports; I found no planner tooling in it. Third-party "everything" builds ship thirty-plus tools, campaign, bid and budget management included. And then there are compact utilities with a handful of commands.
I took the compact one, **google-keyword-planner-mcp**: exactly three tools — keyword ideas, historical metrics, click forecast. A native executable of 28 MB, no Python or Node.js runtime, open source under MIT, readable in an evening.
The reasoning is simple, and it is the through-line of everything I do with AI tooling: the assistant gets precisely the surface the job needs. A server that manages campaigns can spend money, which means one day it will spend money unasked. A server with three read calls can do nothing but hand back numbers. The same principle drives our [safe AI agent rollout service](https://www.it-deweloper.pl/en/web/ai/ai-mcp-security-audit).
## The big one: developer tokens were retired on 9 September 2026
This is where most of my time went, so it goes first. The old routine: create a Google Ads manager account (MCC), collect a developer token — a 22-character string — from the API Centre, and send it as a header with every request. Almost every guide a search engine offers still describes exactly that.
I followed it to the end: manager account created, token issued, token pasted into the server config. Only then did I reach the documentation, which states plainly that **developer tokens were sunset on 9 September 2026**. The header is now ignored, and the access level is determined by the **Google Cloud project** that issued your OAuth credentials. Applications submitted through the API Centre are no longer processed, and the ones still queued were closed by Google with a request to re-apply — this time in the Cloud Console.
The new ladder looks like this:
- **Test** — granted automatically the moment you enable the Google Ads API in your Cloud project. Test accounts only.
- **Explorer** — the first level that sees live accounts: 2,880 operations a day. The catch: planner tooling is **not available** here, as Google classes it among restricted services.
- **Basic** — 15,000 operations a day, and the level that actually opens Keyword Planner. It requires brand verification for the Cloud project; after that the application is reviewed automatically, in minutes.
- **Standard** — no daily cap, aimed at large platforms; review takes up to ten working days.
The conclusion I wish I had read first: if the planner is what you need, there is exactly one path — a Google Cloud project, the Ads API enabled, brand verification, and an application for Basic. A manager account is not part of it at all.
## Step by step, by hand
1. **A Google Cloud project.** Enabling the Google Ads API puts the project on Test level straight away.
2. **An OAuth client of the Desktop app type.** It yields a client ID and secret pair. For a desktop program that is the normal scenario: Google does not treat such a secret as confidential.
3. **One-off authorisation.** A short script opens a listener on a local port, launches Google's consent screen with the Ads scope, catches the returned code and exchanges it for a refresh token. The two parameters that matter are offline access and forced consent — without them no refresh token is issued.
4. **The account ID.** Ten digits, no dashes — the ad account the data is requested for.
5. **The server on disk.** I downloaded the build for my system and dropped it in its own folder. No runtime to install: it is a single file. Mine went to the D: drive, because the system drive was full.
6. **Registering it with the assistant.** One command, scoped to the user so the server is available in every project rather than a single directory.
```
claude mcp add keyword-planner \
--scope user \
-e GOOGLE_ADS_CLIENT_ID=... \
-e GOOGLE_ADS_REFRESH_TOKEN=... \
-e GOOGLE_ADS_CUSTOMER_ID=... \
-- D:\mcp\kwp-mcp.exe
```
The detail that trips everyone up: the client reads the tool list at start-up. A server registered while a session is open stays invisible to it — you need a new chat or an application restart. That is not an installation failure.
## Testing the protocol without the assistant
Before hunting for the problem inside the assistant, it pays to confirm the server is alive at all. MCP speaks JSON-RPC over standard input and output, so you can interrogate it by hand: run the executable, push three lines into its input and read what comes back.
1. `initialize` — the protocol-version handshake;
2. `notifications/initialized` — the acknowledgement;
3. `tools/list` — the tool listing.
If three tools come back, the server and the credentials are fine, and you can move on to a real `tools/call`. The test saves hours because it splits the problem cleanly into "the server is not answering" and "the client cannot see it".
## Where it stalled: a 403 from Google
Protocol alive, tools listed — and the first real request came back refused:
```
PERMISSION_DENIED
ACTION_NOT_PERMITTED
The Google Cloud project is only
approved for use with test accounts.
```
The message is honest: the project sits on Test level and will not be handed a live ad account. It has nothing to do with keywords, seeds or regions.
And here is the trap I fell into anyway: after a refusal the instinct is to reword the request — switch language, drop some seeds, try another country. Pointless. The error is about the access level of the whole project, not about a particular call. The only cure is brand verification and a Basic application.
One more note for anyone searching that error text: older API versions return `ACTION_NOT_PERMITTED`, while the latest one answers with a different code. The same cause wearing two faces is genuinely confusing.
## How long it took
The technical part ran to about an hour: download the file, create the OAuth client, obtain a refresh token, register the server, check the protocol. Everything else went to Google's administrative side — first the obsolete manager-account route, then working out the new scheme, then brand verification, which wants a verified domain and a completed consent screen.
If you are planning this for a project, budget a day for paperwork and an hour for installation, not the other way round.
## Security: what I would do differently
- **Keep secrets out of scripts.** Mine sat in a test file while I was debugging, which is a bad habit: they belong in environment variables or a secret store, and the file belongs in the ignore list.
- **Fewer tools, smaller surface.** Three read functions cannot create a campaign or change a bid. A server that can do those things demands a completely different level of trust.
- **A separate Cloud project for the integration.** It makes revoking access wholesale trivial without touching anything else.
- **Read the code before running it.** Twenty-eight megabytes is a compiled binary, but the sources are open: half an hour of reading is cheaper than one incident.
## What it gives you day to day
With access open the loop is short: you are writing a page, you ask how many people in Poland search that phrase and which wording is more common, and the numbers arrive in the same window with no exports. The same route covers new service ideas, negative keyword lists and seasonality.
Full disclosure about my own status on the day of publishing: the project is still on Test level and the Basic application is queued. So there are no live-account numbers in this article — only the working scheme and the rakes I stepped on. When access opens, I will come back and add real measurements.
## Is it worth repeating
If you write regularly, run ads, or own a website where decisions follow demand — yes. The integration removes context switching, which is the single biggest time sink in that work. If you open the planner once a quarter, the panel by hand is simpler.
And finally: the September reform means most Google Ads API guides are now out of date. Before repeating someone's walkthrough, check the official documentation — its date matters more than a repository's star count.
[We can wire Keyword Planner into your AI assistant for you](https://www.it-deweloper.pl/en/web/ai/ai-keyword-research) — on your computer or in your cloud, Google access arrangements included.
14 September 2026 | [Victor Parhimchik](https://www.it-deweloper.pl/index.php?option=com_contact&view=contact&id=1&catid=4) | [IT Deweloper Blog](https://www.it-deweloper.pl/index.php?option=com_content&view=category&id=29)
[ 
### How to Write Your First Query on GA4 Data in BigQuery
Once Google Analytics 4 is linked to BigQuery, raw events appear in your warehouse every day: every page view, click and enquiry with all its paramet…
](https://www.it-deweloper.pl/index.php?option=com_content&view=article&id=300:ga4-bigquery-first-query&catid=29&lang=en-GB)
[ 
### How Google Tag Gateway Works and Whether to Turn It On
Google tag gateway is a feature that lets you load Google tags from your own domain instead of Google’s servers. It’s often described as a way to “by…
](https://www.it-deweloper.pl/index.php?option=com_content&view=article&id=299:how-google-tag-gateway-works&catid=29&lang=en-GB)
[ 
### How to Check Your Core Web Vitals and Read the Numbers
Core Web Vitals are three metrics Google uses to judge how comfortable a page is to use: how quickly the main content appears, how quickly the page r…
](https://www.it-deweloper.pl/index.php?option=com_content&view=article&id=298:check-core-web-vitals&catid=29&lang=en-GB)
[ 
### How to Set Up SPF, DKIM and DMARC for Google Workspace
If emails from your domain land in spam or don’t arrive at all, the first thing to check is three DNS records: SPF, DKIM and DMARC. Since 2024, Gmail…
](https://www.it-deweloper.pl/index.php?option=com_content&view=article&id=297:google-workspace-spf-dkim-dmarc&catid=29&lang=en-GB)
[ 
### How to Choose reCAPTCHA for a Form and Get the Keys
reCAPTCHA protects your website forms from spam bots. During 2025, Google moved all reCAPTCHA keys to Google Cloud, so many older guides are out of d…
](https://www.it-deweloper.pl/index.php?option=com_content&view=article&id=296:choose-recaptcha-version&catid=29&lang=en-GB)
[ 
### How to Embed a Google Map on Your Website Without an API Key
A map on your Contact page helps customers see where you are and get directions straight away. You don’t need an API key or a payment card in Google…
](https://www.it-deweloper.pl/index.php?option=com_content&view=article&id=295:embed-google-map-on-website&catid=29&lang=en-GB)
[ 
### How to Check That Google Ads Conversions Are Tracked
Google Ads learns from conversions: enquiries, calls, purchases. If they’re counted wrongly, the system optimises your campaigns blind — spending bud…
](https://www.it-deweloper.pl/index.php?option=com_content&view=article&id=294:check-google-ads-conversions&catid=29&lang=en-GB)
[ 
### How to Build a Data Studio Report from Analytics and GSC
Data Studio is Google’s free tool for reports and dashboards. In April 2026 Google brought back this name; for several years before that it was calle…
](https://www.it-deweloper.pl/index.php?option=com_content&view=article&id=293:data-studio-first-report&catid=29&lang=en-GB)
[ 
### How to Check If Consent Mode v2 Works on Your Website
Google Consent Mode v2 passes the choice a visitor made in your cookie banner to Google Analytics and Google Ads. A banner can look perfect and still…
](https://www.it-deweloper.pl/index.php?option=com_content&view=article&id=292:check-consent-mode-v2&catid=29&lang=en-GB)
[ 
### How to Install Google Tag Manager on Your Website
Google Tag Manager is a “box” for all the tracking codes on your site: Google Analytics, Google Ads conversions, social media pixels. You install the…
](https://www.it-deweloper.pl/index.php?option=com_content&view=article&id=291:install-google-tag-manager&catid=29&lang=en-GB)
[](#)
[](#)
## Build your website
Find out what your website will cost
[ Pricing ](https://www.it-deweloper.pl/index.php?Itemid=262&lang=en-GB)
### [ Contact ](https://www.it-deweloper.pl/index.php?Itemid=277&lang=en-GB)
Web studio IT Deweloper website development, Poland. 5423493188
SEOAIAdsWebSMM
### Address
Nowogródzka 4A
Białystok, 15-490, PL
[
### Phone
+48 731 190 041
](tel:+48731190041)
[
### Email
This email address is being protected from spambots. You need JavaScript enabled to view it.
](mailto:office@it-deweloper.pl)
[
### WhatsApp
](https://wa.me/48731190041)
[
### Telegram
](https://t.me/+48731190041)
Opening hours:
- Monday
0900–1800
- Tuesday
0900–1800
- Wednesday
0900–1800
- Thursday
0900–1800
- Friday
0900–1800
- Saturday
0900–1600
- Sunday
closed
Web development can be interesting! Our social media, with content about building websites.
- [](https://www.facebook.com/ITdeweloper)
- [](https://www.linkedin.com/company/it-deweloper)
- [](https://t.me/IT_deweloper)
- [](https://www.instagram.com/it_deweloper/)
**it-deweloper** — a web development studio.
We design and build modern websites and online stores.
© [it-deweloper](https://it-deweloper.pl/en).
All rights reserved.
[Privacy Policy](https://www.it-deweloper.pl/index.php?Itemid=313&lang=en)