Ads MCP
MCP server for Google Ads and Meta Ads. Wraps both APIs directly to manage campaigns.
- Pricing
- Open source
- Runs
- Locally
- Version
- 0.1.1
- Listing updated
- 5 days ago
About Ads MCP
Ads MCP is an open-source MCP server for marketing and seo. It runs locally on your machine and is started by your AI client.
Install
Run in a terminal
claude mcp add ads-mcp --env GOOGLE_ADS_CLIENT_ID='<GOOGLE_ADS_CLIENT_ID>' --env GOOGLE_ADS_CLIENT_SECRET='<GOOGLE_ADS_CLIENT_SECRET>' --env GOOGLE_ADS_DEVELOPER_TOKEN='<GOOGLE_ADS_DEVELOPER_TOKEN>' --env GOOGLE_ADS_REFRESH_TOKEN='<GOOGLE_ADS_REFRESH_TOKEN>' --env GOOGLE_ADS_CUSTOMER_ID='<GOOGLE_ADS_CUSTOMER_ID>' --env META_APP_ID='<META_APP_ID>' --env META_APP_SECRET='<META_APP_SECRET>' --env META_ACCESS_TOKEN='<META_ACCESS_TOKEN>' --env META_AD_ACCOUNT_ID='<META_AD_ACCOUNT_ID>' -- npx -y @gudlab/ads-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"ads-mcp": {
"command": "npx",
"args": [
"-y",
"@gudlab/ads-mcp"
],
"env": {
"GOOGLE_ADS_CLIENT_ID": "<GOOGLE_ADS_CLIENT_ID>",
"GOOGLE_ADS_CLIENT_SECRET": "<GOOGLE_ADS_CLIENT_SECRET>",
"GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
"GOOGLE_ADS_REFRESH_TOKEN": "<GOOGLE_ADS_REFRESH_TOKEN>",
"GOOGLE_ADS_CUSTOMER_ID": "<GOOGLE_ADS_CUSTOMER_ID>",
"META_APP_ID": "<META_APP_ID>",
"META_APP_SECRET": "<META_APP_SECRET>",
"META_ACCESS_TOKEN": "<META_ACCESS_TOKEN>",
"META_AD_ACCOUNT_ID": "<META_AD_ACCOUNT_ID>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"ads-mcp": {
"command": "npx",
"args": [
"-y",
"@gudlab/ads-mcp"
],
"env": {
"GOOGLE_ADS_CLIENT_ID": "<GOOGLE_ADS_CLIENT_ID>",
"GOOGLE_ADS_CLIENT_SECRET": "<GOOGLE_ADS_CLIENT_SECRET>",
"GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
"GOOGLE_ADS_REFRESH_TOKEN": "<GOOGLE_ADS_REFRESH_TOKEN>",
"GOOGLE_ADS_CUSTOMER_ID": "<GOOGLE_ADS_CUSTOMER_ID>",
"META_APP_ID": "<META_APP_ID>",
"META_APP_SECRET": "<META_APP_SECRET>",
"META_ACCESS_TOKEN": "<META_ACCESS_TOKEN>",
"META_AD_ACCOUNT_ID": "<META_AD_ACCOUNT_ID>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"ads-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@gudlab/ads-mcp"
],
"env": {
"GOOGLE_ADS_CLIENT_ID": "<GOOGLE_ADS_CLIENT_ID>",
"GOOGLE_ADS_CLIENT_SECRET": "<GOOGLE_ADS_CLIENT_SECRET>",
"GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
"GOOGLE_ADS_REFRESH_TOKEN": "<GOOGLE_ADS_REFRESH_TOKEN>",
"GOOGLE_ADS_CUSTOMER_ID": "<GOOGLE_ADS_CUSTOMER_ID>",
"META_APP_ID": "<META_APP_ID>",
"META_APP_SECRET": "<META_APP_SECRET>",
"META_ACCESS_TOKEN": "<META_ACCESS_TOKEN>",
"META_AD_ACCOUNT_ID": "<META_AD_ACCOUNT_ID>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"ads-mcp": {
"command": "npx",
"args": [
"-y",
"@gudlab/ads-mcp"
],
"env": {
"GOOGLE_ADS_CLIENT_ID": "<GOOGLE_ADS_CLIENT_ID>",
"GOOGLE_ADS_CLIENT_SECRET": "<GOOGLE_ADS_CLIENT_SECRET>",
"GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
"GOOGLE_ADS_REFRESH_TOKEN": "<GOOGLE_ADS_REFRESH_TOKEN>",
"GOOGLE_ADS_CUSTOMER_ID": "<GOOGLE_ADS_CUSTOMER_ID>",
"META_APP_ID": "<META_APP_ID>",
"META_APP_SECRET": "<META_APP_SECRET>",
"META_ACCESS_TOKEN": "<META_ACCESS_TOKEN>",
"META_AD_ACCOUNT_ID": "<META_AD_ACCOUNT_ID>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"ads-mcp": {
"command": "npx",
"args": [
"-y",
"@gudlab/ads-mcp"
],
"env": {
"GOOGLE_ADS_CLIENT_ID": "<GOOGLE_ADS_CLIENT_ID>",
"GOOGLE_ADS_CLIENT_SECRET": "<GOOGLE_ADS_CLIENT_SECRET>",
"GOOGLE_ADS_DEVELOPER_TOKEN": "<GOOGLE_ADS_DEVELOPER_TOKEN>",
"GOOGLE_ADS_REFRESH_TOKEN": "<GOOGLE_ADS_REFRESH_TOKEN>",
"GOOGLE_ADS_CUSTOMER_ID": "<GOOGLE_ADS_CUSTOMER_ID>",
"META_APP_ID": "<META_APP_ID>",
"META_APP_SECRET": "<META_APP_SECRET>",
"META_ACCESS_TOKEN": "<META_ACCESS_TOKEN>",
"META_AD_ACCOUNT_ID": "<META_AD_ACCOUNT_ID>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
GOOGLE_ADS_CLIENT_IDOAuth client ID from Google Cloud ConsoleRequiredGOOGLE_ADS_CLIENT_SECRETOAuth client secret from Google Cloud ConsoleRequiredGOOGLE_ADS_DEVELOPER_TOKENDeveloper token from Google Ads API CenterRequiredGOOGLE_ADS_REFRESH_TOKENRefresh token minted via `pnpm google:auth`RequiredGOOGLE_ADS_CUSTOMER_IDDefault Google Ads account ID, 10 digits, no dashesRequiredGOOGLE_ADS_LOGIN_CUSTOMER_IDMCC account ID, only if the customer account is managed under oneMETA_APP_IDMeta App ID from developers.facebook.comRequiredMETA_APP_SECRETMeta App secretRequiredMETA_ACCESS_TOKENLong-lived System User access token with ads_management scopeRequiredMETA_AD_ACCOUNT_IDDefault Meta ad account ID, numeric, no act_ prefixRequired
Pricing
Open source
Ads MCP FAQ
Is Ads MCP free?
Yes. Ads MCP is open source, so you can use and self-host it for free.
How do I add Ads MCP to Claude Code?
Run this command in your terminal: claude mcp add ads-mcp --env GOOGLE_ADS_CLIENT_ID='<GOOGLE_ADS_CLIENT_ID>' --env GOOGLE_ADS_CLIENT_SECRET='<GOOGLE_ADS_CLIENT_SECRET>' --env GOOGLE_ADS_DEVELOPER_TOKEN='<GOOGLE_ADS_DEVELOPER_TOKEN>' --env GOOGLE_ADS_REFRESH_TOKEN='<GOOGLE_ADS_REFRESH_TOKEN>' --env GOOGLE_ADS_CUSTOMER_ID='<GOOGLE_ADS_CUSTOMER_ID>' --env META_APP_ID='<META_APP_ID>' --env META_APP_SECRET='<META_APP_SECRET>' --env META_ACCESS_TOKEN='<META_ACCESS_TOKEN>' --env META_AD_ACCOUNT_ID='<META_AD_ACCOUNT_ID>' -- npx -y @gudlab/ads-mcp
What are the best alternatives to Ads MCP?
The closest alternatives to Ads MCP are Google Ads + Meta Ads + SEO/GEO MCP, Calven, Snapchat Ads MCP Server, MCP and Red Center Studio free tools.
Where this comes from
- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.
Alternatives to Ads MCP

Google Ads + Meta Ads + SEO/GEO MCP
MCP serverHosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat
- 8 tools
- Remote
- Freemium
- 8.2K GitHub stars
- Marketing and SEO

Calven
MCP serverProduct marketing context from Calven delivered into Claude, ChatGPT and other AI tools
- Remote
- Free trial
- 3 GitHub stars
- Marketing and SEO
Snapchat Ads MCP Server
MCP serverSelf-hostable MCP server for managing Snapchat Ads campaigns, reports and audiences from
Not checked yet- Remote
- Open source
- 8 GitHub stars
- Marketing and SEO

MCP
MCP serverMCP server for planning, scheduling and measuring social and ad campaigns with approvals
- Remote
- Freemium
- Marketing and SEO

Red Center Studio free tools
MCP serverFree website checks for AI readiness, DNS dependencies, domain health and Bubble errors
- 5 tools
- Remote
- Free
- Marketing and SEO

ASOScan
MCP serverASO data for your own iOS and Android apps: rankings, keywords, reviews, scores
- Remote
- Free trial
- Marketing and SEO