Install Ads in Claude Desktop
What you need first
- Claude Desktop, installed.
- Node.js, which
gives the
npxcommand the server starts with. - Your own values for
YOUR_GOOGLE_ADS_CLIENT_ID,YOUR_GOOGLE_ADS_CLIENT_SECRET,YOUR_GOOGLE_ADS_DEVELOPER_TOKEN,YOUR_GOOGLE_ADS_REFRESH_TOKEN,YOUR_GOOGLE_ADS_CUSTOMER_ID,YOUR_META_APP_ID,YOUR_META_APP_SECRET,YOUR_META_ACCESS_TOKEN,YOUR_META_AD_ACCOUNT_ID.
Steps
- In Claude Desktop, open Settings › Developer and choose Edit Config. It opens
claude_desktop_config.json. - Add this block. If the file already has
mcpServers, add only the entry inside it.
{
"mcpServers": {
"ads-mcp": {
"command": "npx",
"args": ["-y", "@gudlab/[email protected]"],
"env": { "GOOGLE_ADS_CLIENT_ID": "YOUR_GOOGLE_ADS_CLIENT_ID", "GOOGLE_ADS_CLIENT_SECRET": "YOUR_GOOGLE_ADS_CLIENT_SECRET", "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_GOOGLE_ADS_DEVELOPER_TOKEN", "GOOGLE_ADS_REFRESH_TOKEN": "YOUR_GOOGLE_ADS_REFRESH_TOKEN", "GOOGLE_ADS_CUSTOMER_ID": "YOUR_GOOGLE_ADS_CUSTOMER_ID", "META_APP_ID": "YOUR_META_APP_ID", "META_APP_SECRET": "YOUR_META_APP_SECRET", "META_ACCESS_TOKEN": "YOUR_META_ACCESS_TOKEN", "META_AD_ACCOUNT_ID": "YOUR_META_AD_ACCOUNT_ID" }
}
}
} - Replace
YOUR_GOOGLE_ADS_CLIENT_ID,YOUR_GOOGLE_ADS_CLIENT_SECRET,YOUR_GOOGLE_ADS_DEVELOPER_TOKEN,YOUR_GOOGLE_ADS_REFRESH_TOKEN,YOUR_GOOGLE_ADS_CUSTOMER_ID,YOUR_META_APP_ID,YOUR_META_APP_SECRET,YOUR_META_ACCESS_TOKEN,YOUR_META_AD_ACCOUNT_IDwith your own values. - Save the file, quit Claude Desktop completely and open it again.
Check it worked
Ask Claude Desktop: List the tools of ads-mcp.
If it does not start
- spawn npx ENOENT
- Node.js is not on the PATH that Claude Desktop sees. Install it, or write the
full path of
npxin the config. - The server starts, but its tools fail
- A
YOUR_…placeholder is still in the config, or its value is wrong. - Nothing changes after a restart
- The file is not valid JSON any more. Look for a missing comma where the block was added.