# Pinterest Ads

Connect an AI client to Pinterest Ads tools for account data and campaign operations. Use it to query reports, audiences, catalogs, or campaign changes.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: get-mcp-ads
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/get-mcp-ads/pinterest-ads-mcp-server
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/pinterest-ads

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `PINTEREST_ACCESS_TOKEN`, `PINTEREST_REFRESH_TOKEN`, `PINTEREST_APP_ID`, `PINTEREST_APP_SECRET`, `PINTEREST_AD_ACCOUNT_IDS`, `PINTEREST_AD_ACCOUNT_ID`, `PINTEREST_ENABLE_WRITES`, `PINTEREST_ENVIRONMENT`, `LOG_LEVEL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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-server
```
Replace <…> with your own values. 4 more environment variables are in the server README

### Codex

**Platform CLI**
```bash
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-server
```
Replace <…> with your own values. 4 more environment variables are in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
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-server
```
Replace <…> with your own values. 4 more environment variables are in the server README

## When to use it
- 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
- 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.

## Similar
- [ads-pinterest](https://affpapa.org/en/nevibecode/skills/ads-pinterest.md) — skill · 576 installs
- [ads-launch](https://affpapa.org/en/nevibecode/skills/ads-launch.md) — skill · 610 installs
- [spotify-ads-api](https://affpapa.org/en/nevibecode/plugins/spotify-ads-api.md) — plugin · ★ 20
- [pinterest-posts](https://affpapa.org/en/nevibecode/skills/pinterest-posts.md) — skill · 2100 installs
- [pinterest-seo](https://affpapa.org/en/nevibecode/skills/pinterest-seo.md) — skill · 614 installs
- [pinterest-pin-design](https://affpapa.org/en/nevibecode/skills/pinterest-pin-design.md) — skill · 604 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md