Pinterest Ads — Claude Code MCP server: features and setup
Connect an AI client to Pinterest Ads tools for account data and campaign operations. Use it to query reports, audiences, catalogs, or campaign changes.
claude mcp add --env PINTEREST_ACCESS_TOKEN=<PINTEREST_ACCESS_TOKEN> --env PINTEREST_REFRESH_TOKEN=<PINTEREST_REFRESH_TOKEN> --env PINTEREST_APP_ID=<PINTEREST_APP_ID> --env PINTEREST_APP_SECRET=<PINTEREST_APP_SECRET> --env PINTEREST_AD_ACCOUNT_IDS=<PINTEREST_AD_ACCOUNT_IDS> --transport stdio pinterest-ads -- npx -y @getmcpads/pinterest-ads-mcp-serverWhat Pinterest Ads does
The server provides 29 tools for reading Pinterest Ads data and 30 for write operations. They cover reports, audiences, catalogs, and native campaign work. Writes are off by default and require confirmation; campaign changes are previewed first.
For local use, you need Pinterest credentials and an MCP client that supports stdio. In Claude Code, add the server with claude mcp add; it runs through the @getmcpads/pinterest-ads-mcp-server package. The required runtime is Node.js 22.23.4, 24.22.1, 26.12.1, or a newer release in those lines. Older versions start the server with a warning on stderr.
What it helps with
- read Pinterest Ads reports through an AI client
- inspect available audience data
- review Pinterest catalog information
- preview a campaign change before applying it
- make confirmed changes to an ad account
Example prompts for the agent
- Summarize the reports for my Pinterest Ads account.
- Check which audiences are available in my Pinterest Ads account.
- Show a preview before renaming a Pinterest Ads campaign.
How to install Pinterest Ads
Platform CLI
claude mcp add --env PINTEREST_ACCESS_TOKEN=<PINTEREST_ACCESS_TOKEN> --env PINTEREST_REFRESH_TOKEN=<PINTEREST_REFRESH_TOKEN> --env PINTEREST_APP_ID=<PINTEREST_APP_ID> --env PINTEREST_APP_SECRET=<PINTEREST_APP_SECRET> --env PINTEREST_AD_ACCOUNT_IDS=<PINTEREST_AD_ACCOUNT_IDS> --transport stdio pinterest-ads -- npx -y @getmcpads/pinterest-ads-mcp-serverReplace <…> with your own values. 4 more environment variables are in the server README
Platform CLI
codex mcp add pinterest-ads --env PINTEREST_ACCESS_TOKEN=<PINTEREST_ACCESS_TOKEN> --env PINTEREST_REFRESH_TOKEN=<PINTEREST_REFRESH_TOKEN> --env PINTEREST_APP_ID=<PINTEREST_APP_ID> --env PINTEREST_APP_SECRET=<PINTEREST_APP_SECRET> --env PINTEREST_AD_ACCOUNT_IDS=<PINTEREST_AD_ACCOUNT_IDS> -- npx -y @getmcpads/pinterest-ads-mcp-serverReplace <…> with your own values. 4 more environment variables are in the server README
Config file
{
"mcpServers": {
"pinterest-ads": {
"command": "npx",
"args": [
"-y",
"@getmcpads/pinterest-ads-mcp-server"
],
"env": {
"PINTEREST_ACCESS_TOKEN": "<PINTEREST_ACCESS_TOKEN>",
"PINTEREST_REFRESH_TOKEN": "<PINTEREST_REFRESH_TOKEN>",
"PINTEREST_APP_ID": "<PINTEREST_APP_ID>",
"PINTEREST_APP_SECRET": "<PINTEREST_APP_SECRET>",
"PINTEREST_AD_ACCOUNT_IDS": "<PINTEREST_AD_ACCOUNT_IDS>"
}
}
}
}Replace <…> with your own values. 4 more environment variables are in the server README
Config file
{
"servers": {
"pinterest-ads": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@getmcpads/pinterest-ads-mcp-server"
],
"env": {
"PINTEREST_ACCESS_TOKEN": "<PINTEREST_ACCESS_TOKEN>",
"PINTEREST_REFRESH_TOKEN": "<PINTEREST_REFRESH_TOKEN>",
"PINTEREST_APP_ID": "<PINTEREST_APP_ID>",
"PINTEREST_APP_SECRET": "<PINTEREST_APP_SECRET>",
"PINTEREST_AD_ACCOUNT_IDS": "<PINTEREST_AD_ACCOUNT_IDS>"
}
}
}
}Replace <…> with your own values. 4 more environment variables are in the server README
Platform CLI
gemini mcp add -e PINTEREST_ACCESS_TOKEN=<PINTEREST_ACCESS_TOKEN> -e PINTEREST_REFRESH_TOKEN=<PINTEREST_REFRESH_TOKEN> -e PINTEREST_APP_ID=<PINTEREST_APP_ID> -e PINTEREST_APP_SECRET=<PINTEREST_APP_SECRET> -e PINTEREST_AD_ACCOUNT_IDS=<PINTEREST_AD_ACCOUNT_IDS> pinterest-ads npx -y @getmcpads/pinterest-ads-mcp-serverReplace <…> with your own values. 4 more environment variables are in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Pinterest Ads
How do I install Pinterest Ads in Claude Code?
Run `claude mcp add pinterest-ads -e PINTEREST_ACCESS_TOKEN=<PINTEREST_ACCESS_TOKEN> -e PINTEREST_REFRESH_TOKEN=<PINTEREST_REFRESH_TOKEN> -e PINTEREST_APP_SECRET=<PINTEREST_APP_SECRET> -- npx -y @getmcpads/pinterest-ads-mcp-server`. You need Pinterest credentials to connect.
What does Pinterest Ads do?
It connects an AI client to Pinterest Ads tools for reading account data and working with reports, audiences, catalogs, and campaigns. Write operations are disabled by default and require confirmation.
Which Node.js version does Pinterest Ads require?
Use Node.js 22.23.4, 24.22.1, 26.12.1, or a newer release in those lines. Older runtimes start the server but produce a warning on stderr.
