GuidesPinterest Ads MCP

Pinterest Ads MCP Server

Connect Claude, ChatGPT, or any AI tool to your Pinterest Ads account. Manage campaigns, create Pins, sync catalogs, build audiences, and analyze performance with natural language.

What is the Pinterest Ads MCP?

The Pipeboard Pinterest Ads MCP (Model Context Protocol) Server connects AI assistants like Claude, ChatGPT, and custom agents to the Pinterest Marketing API. Manage campaigns, create Pins and ad creatives, sync product catalogs, build audiences, track conversions, and analyze performance through natural language.

Instead of navigating Pinterest Ads Manager or building API integrations from scratch, you get instant access to the full campaign lifecycle, Shopping catalogs, keyword and audience targeting, the Conversions API, and reporting.

Key features:

40+ pre-built tools across campaigns, ad groups, ads, Pins, catalogs, audiences, and conversions

Works with Claude Desktop, ChatGPT, Python, n8n, and any MCP client

Create Pins and image/video ad creatives, with ad previews before launch

Audience targeting: keywords, customer lists, and saved audiences

Shopping catalog management and conversion tracking via the Conversions API

Performance analytics with campaign, ad group, and ad-level breakdowns plus async reports

Getting Started

Set up in under 2 minutes

1. Sign up for a Pipeboard account:

pipeboard.co/auth/signup →

2. Connect your Pinterest Ads account:

pipeboard.co/connections →

3. Add the MCP server to Claude (or another MCP client):

https://pinterest-ads.mcp.pipeboard.co/

Use this URL as a Streamable HTTP MCP server in your client. Authentication is handled automatically through your Pipeboard session.

Connect to Your AI Tool

The Pinterest Ads MCP works with any MCP-compatible client. Just add the server URL and start managing your campaigns with natural language.

Claude Pro / Max

Recommended

1.Open claude.ai/customize/connectors
2.Click "Add custom connector"
3.URL: https://pinterest-ads.mcp.pipeboard.co/

ChatGPT

Developer mode

1.Enable Developer mode in ChatGPT Settings
2.Settings → Apps → Advanced → Developer mode
3.Create app with MCP URL

Claude Code

CLI / VS Code

Run this command in your terminal:

claude mcp add --transport http pipeboard-pinterest-ads https://pinterest-ads.mcp.pipeboard.co/

Then type /mcp in Claude Code to authenticate with Pipeboard.

Alternative: use an API token for instant setup (no browser auth needed):

claude mcp add --transport http pipeboard-pinterest-ads https://pinterest-ads.mcp.pipeboard.co/?token=pk_...

Get your token at pipeboard.co/api-tokens

Claude Desktop JSON configuration:

Add this to your Claude Desktop MCP settings (Settings → MCP Servers → Add):

claude_desktop_config.json

{
  "mcpServers": {
    "pinterest-ads": {
      "url": "https://pinterest-ads.mcp.pipeboard.co/"
    }
  }
}

More integrations:

Python + LangChain

Build custom AI agents and automation

View guide →

n8n Automation

No-code workflow automation with MCP nodes

View guide →

Any MCP Client

Use the URL in any compatible client

View guide →

Try these prompts

Campaign Overview

"List my Pinterest ad accounts and show campaign performance for the last 30 days"

Pin & Ad Creation

"Create a Pin from this image on my Summer board and use it in a new ad in my active ad group"

Audience Building

"Show my Pinterest audiences and create a customer list audience from this email list"

Performance Analysis

"Break down my Pinterest ad spend vs conversions by ad group for the last 7 days. Which should I scale?"

Available Tools

The Pinterest Ads MCP provides 40+ tools organized by category. All tools are available through natural language when connected to an AI assistant.

Account & Discovery

list_pinterest_ad_accounts

List all authorized ad accounts across connections

Campaigns

get_pinterest_campaigns

List campaigns with status filtering

create_pinterest_campaign

Create campaigns with objective and budget

update_pinterest_campaign

Update campaign name, budget, or status

pause_pinterest_campaigns

Pause one or more campaigns

Ad Groups

get_pinterest_ad_groups

List ad groups with targeting and budgets

create_pinterest_ad_group

Create ad groups with targeting and bidding

update_pinterest_ad_group

Update targeting, budget, bid, or schedule

pause_pinterest_ad_groups

Pause one or more ad groups

Ads, Pins & Creatives

get_pinterest_ads

List ads with creative details and status

create_pinterest_ad

Create an ad from a Pin

update_pinterest_ad

Update ad name, status, or tracking

pause_pinterest_ads

Pause one or more ads

create_pinterest_pin

Create a Pin (image/video) on a board

create_pinterest_ad_preview

Generate an ad preview before launch

get_pinterest_pins

List Pins for an ad account

get_pinterest_boards

List boards available for Pins

Media Uploads

list_pinterest_media_uploads

List registered media uploads

get_pinterest_media_upload_status

Check upload processing status

Audiences & Targeting

get_pinterest_audiences

List saved audiences

create_pinterest_audience

Create a targeting audience

update_pinterest_audience

Update an audience definition

get_pinterest_customer_lists

List customer-list audiences

create_pinterest_customer_list

Create a customer list from records

update_pinterest_customer_list

Add or remove customer-list records

get_pinterest_keywords

List keywords for a campaign/ad group

create_pinterest_keywords

Add keyword targeting

update_pinterest_keywords

Update keyword bids or match types

Catalogs (Shopping)

get_pinterest_catalogs

List product catalogs

create_pinterest_catalog

Create a product catalog

get_pinterest_catalog_product_groups

List catalog product groups

create_pinterest_catalog_product_group

Create a product group

get_pinterest_catalog_product_group_products

List products in a group

get_pinterest_catalog_items_batch_status

Check catalog item batch status

Conversions

get_pinterest_conversion_tags

List conversion tags

create_pinterest_conversion_tag

Create a conversion tag

upload_pinterest_conversion_events

Send server-side events (Conversions API)

get_pinterest_conversion_event_quality

Inspect event match quality

Analytics & Reporting

get_pinterest_analytics

Performance metrics with date ranges and breakdowns

submit_pinterest_async_report

Queue a large async report

get_pinterest_async_report_status

Poll an async report and fetch the URL

Campaign Objectives

Choose an objective when creating Pinterest campaigns:

AWARENESS

Maximize reach and brand awareness

CONSIDERATION

Drive traffic and clicks to your site

VIDEO_VIEW

Get more views on video Pins

WEB_CONVERSION

Optimize for on-site conversions

CATALOG_SALES

Drive product sales from your catalog

WEB_SESSIONS

Drive sessions and qualified visits

Best Practices

Call list_pinterest_ad_accounts first — every per-account tool requires the ad_account_id it returns
Create Pins with high-quality vertical images (2:3 aspect ratio, 1000x1500) for best performance
Combine keyword and audience targeting to balance reach with relevance
Set up a conversion tag and upload conversion events so WEB_CONVERSION campaigns optimize accurately
Use submit_pinterest_async_report for large date ranges instead of get_pinterest_analytics
Use create_pinterest_ad_preview to review creatives before launching ads

Pin & Creative Formats

Ads on Pinterest are built from Pins. The MCP supports the main creative formats:

IMAGE PIN

Standard image Pin. Vertical 2:3 (1000x1500) recommended.

VIDEO PIN

Video creative for VIDEO_VIEW and awareness campaigns.

CATALOG / SHOPPING

Product Pins sourced from a synced catalog for CATALOG_SALES.

Support & Documentation

Need help?

Browse all guides - Step-by-step tutorials and workflows Meta Ads MCP Server - If you also manage Meta campaigns TikTok Ads MCP Server - If you also manage TikTok campaigns Google Ads MCP Server - If you also manage Google campaigns Contact support - Get help from our team

Ready to connect your AI tools to Pinterest Ads?

Get started with the Pinterest Ads MCP in under 2 minutes.