otheroauth2

Pinterest

Pinterest is a visual discovery platform for finding ideas like recipes, home and style inspiration, and more.

Verdict

The Pinterest MCP lets your team create, organize, and analyze Pinterest content directly from Switchy. @mention it to draft Pins, build boards, manage sections, or pull account analytics without leaving your workspace. Designers can batch-create visual campaigns, marketers can audit performance metrics across date ranges, and social teams can structure content libraries in real time. Note that creating Pins in production requires Pinterest Standard access — trial apps can read but not write. Secret board operations need the boards:write_secret scope.

Common use cases

  • Draft and publish Pins from campaign briefs
  • Organize product launches into board sections
  • Pull weekly analytics for performance reviews
  • Audit existing boards before seasonal refreshes
  • Batch-create carousel Pins from asset folders

Integration

Vendor
Pinterest
Category
other
Auth
OAUTH2
Tools
24
Composio slug
pinterest

Tools

  • Create Board

    Create a public or secret Pinterest board. Secret creation requires boards:write_secret.

  • Create Board Section

    Create a named section within a Pinterest board.

  • Create Pin

    Create an image, carousel, or registered-video Pin on a Pinterest board. Production execution requires Pinterest Standard access: Trial apps are explicitly blocked from creating Pins on api.pinterest.com and must use a separately authentica

  • Delete Board
    destructive

    Permanently delete a Pinterest board by ID, including a secret board when authorized.

  • Delete Board Section
    destructive

    Permanently delete a section from a Pinterest board.

  • Delete Pin
    destructive

    Permanently delete a Pinterest Pin by ID. Production Pin writes require Pinterest Standard access.

  • Get Account Analytics

    Get aggregate Pinterest account analytics over a UTC date range, with optional metric, content, platform, source, and split filters.

  • Get Board

    Get one Pinterest board by ID, including secret boards available to the connected account.

  • Get Inspiration Trends

    Get Pinterest editorial trend articles or featured trend topics for a supported region.

  • Get Keyword Trends

    Find Pinterest's top growing, monthly, yearly, or seasonal search keywords for a supported market, optionally filtered to an audience or search terms.

  • Get Pin

    Get one public or secret Pinterest Pin by ID.

  • Get Pin Analytics

    Get daily, summary, and lifetime analytics for one Pinterest Pin over a date range. Recent daily values may remain in PROCESSING status.

  • Get Product Trends

    Get currently growing shopping categories or detailed trend metrics for specified leaf product categories.

  • Get Profile

    Get the connected Pinterest account's profile and content counts.

  • Get Top Pins

    Return the connected account's top regular or video Pinterest Pins ranked by a route-appropriate analytics metric.

  • Get Website Verification

    Get the connected account's website-claim verification methods and material. The response contains sensitive verification values.

  • List Boards

    List the connected account's public, protected, or secret Pinterest boards one page at a time.

  • List Board Sections

    List sections within a Pinterest board one page at a time.

  • List Pins

    List account Pins, Pins on a board, or Pins in a board section using one parameterized read tool. Account-level listing may omit secret-board Pins; provide board_id for reliable secret-board inventory.

  • List Profile Resources

    List followers, followed users, followed boards, followed interests, claimed websites, or linked businesses for the connected Pinterest profile.

  • Search Own Content

    Search the connected account's own boards or Pins, including secret content when authorized. This does not search Pinterest's global partner Pin index.

  • Update Board

    Update a board's name, description, or privacy. Provide at least one update field. Secret-board writes require boards:write_secret.

  • Update Board Section

    Rename a section within a Pinterest board.

  • Update Pin

    Update content on a Pin owned by the connected account or move it to another board or section. Provide at least one update field. Production Pin writes require Pinterest Standard access. This Organic action does not support Business Access

Setup

Setup guide

  1. 11. In Switchy, open your workspace settings and navigate to the Integrations tab. 2. Click 'Add Integration' and select Pinterest from the list. 3. You'll be redirected to Pinterest's OAuth consent screen — sign in with the account that owns the boards and Pins you want to manage. 4. Grant the requested scopes: boards:read, boards:write, pins:read, pins:write, and analytics:read (add boards:write_secret if you manage private boards). 5. Pinterest redirects you back to Switchy with a success confirmation. 6. Open any Project, type '@Pinterest get board [board_id]' in the chat, and confirm the MCP returns board details — this verifies the connection is live. 7. To create content, ensure your Pinterest app has Standard access (trial apps cannot write Pins in production).

What teammates see: by default, memories from Pinterest are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Projects have used this MCP together with a given model.

How Switchy teams use it

Not enough Projects yet to publish anonymised usage stats (we require ≥ 50 Projects per week).

Starter prompts

Create Campaign Board

@Pinterest create a public board called 'Spring 2025 Launch' with the description 'New collection preview and styling inspiration'. Then create three sections: 'Product Shots', 'Lifestyle', and 'User Content'.

Publish Product Pin

@Pinterest create a Pin on board [board_id] using image https://example.com/product.jpg, title 'Linen Blend Midi Dress', description 'Effortless summer style in breathable linen', and link https://shop.example.com/dress.

Monthly Analytics Report

@Pinterest get account analytics from 2025-04-01 to 2025-04-30, filtered by engagement metrics and split by platform. Summarize top-performing content types.

Audit Board Structure

@Pinterest get board [board_id] and list all sections with their Pin counts. Flag any empty sections or outdated descriptions.

Clean Up Old Pins

@Pinterest delete the following Pins: [pin_id_1], [pin_id_2], [pin_id_3]. Confirm each deletion and report any errors.

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@pinterest show me my account analytics for the last 30 days, broken down by content type and platform

Output

Here's your Pinterest account performance for the past 30 days: **Total Impressions:** 47,320 (+12% vs. prior period) **Engagements:** 2,140 (4.5% engagement rate) **Pin clicks:** 890 **Saves:** 620 **By Content Type:** - Image Pins: 38,200 impressions, 1,780 engagements - Video Pins: 9,120 impressions, 360 engagements **By Platform:** - Mobile: 72% of impressions - Desktop: 28% of impressions Your video content is driving 40% higher engagement rates than static images, though it represents only 19% of total impressions.

Notes

Analytics require boards:read scope. Date ranges must be in UTC and Pinterest aggregates data daily, so expect 24-48 hour delays for recent activity. The split-by filters (content type, platform, source) help identify what's working, but you can't drill into individual Pin performance through this endpoint.

Prompt

@pinterest create a new board called 'Q2 Product Launches' and add a section for 'Hero Images' inside it

Output

Board created successfully: **Board:** Q2 Product Launches - **ID:** 1234567890123456789 - **Privacy:** Public - **URL:** pinterest.com/yourcompany/q2-product-launches/ **Section added:** Hero Images - **Section ID:** 9876543210987654321 You can now pin content directly to this section. Note that this board is public by default — if you need it private, you'll need boards:write_secret scope and must specify privacy during creation.

Notes

Board and section creation requires boards:write (or boards:write_secret for private boards). Trial-tier Pinterest apps can create boards and sections, but cannot create Pins — you'll need Pinterest Standard API access approved by Pinterest to actually populate this board programmatically. Boards are public unless explicitly created as secret.

Prompt

@pinterest find all my boards related to 'marketing' and summarize which ones have the most saves in the last quarter

Output

I found 4 boards matching 'marketing': 1. **Content Marketing Ideas** (ID: 111...) - 23 Pins, last updated 3 days ago - Cannot retrieve save counts directly; Pinterest's board endpoint returns metadata but not engagement metrics per board. 2. **Social Media Templates** (ID: 222...) - 47 Pins, last updated 1 week ago 3. **Email Campaign Inspiration** (ID: 333...) - 15 Pins, last updated 2 months ago 4. **Marketing Analytics** (ID: 444..., Secret board) - 8 Pins, last updated yesterday To get save counts, you'd need to query account analytics with board-level filtering, which requires correlating board IDs with analytics data separately.

Notes

This example combines the Get Board tool with AI reasoning to filter by keyword. However, Pinterest's API doesn't expose per-board save counts directly through the board metadata endpoint — you'd need to cross-reference with analytics data or individual Pin metrics. Secret boards are only visible if your OAuth token has appropriate access to that account.

Use-case deep-dives

E-commerce product launch coordination

When Pinterest MCP beats manual board curation for product drops

A 6-person DTC brand team launches 12 new SKUs every quarter and needs to coordinate product imagery across Pinterest boards before the email blast goes out. The Pinterest MCP wins here because Create Pin and Create Board Section let the team script the entire board structure from their product database—no copy-paste, no missed variants. The OAuth2 flow means your designer authenticates once and the whole team shares the workspace context. The catch: production Pin creation requires Pinterest Standard access, so trial accounts hit a wall. If your launch cadence is monthly or faster and you're already paying for Standard, this MCP turns a 90-minute manual task into a 5-minute script run. Connect it to your Shopify or product sheet and let Switchy handle the board build while your team reviews the layout.

Agency client reporting automation

Why Get Account Analytics makes sense for multi-client social shops

A 3-person social media agency manages Pinterest for 8 clients and needs to pull monthly performance data without logging into eight separate accounts. The Pinterest MCP's Get Account Analytics tool solves this if each client grants OAuth2 access to the agency's Switchy workspace—one query pulls UTM splits, platform breakdowns, and date-range aggregates for any connected account. The limitation: you're still bound by Pinterest's rate limits and the MCP doesn't batch requests, so pulling analytics for all 8 clients in one conversation can take 30 seconds. If your reporting template is consistent and you bill clients for Pinterest strategy, this MCP cuts the data-gathering step from 40 minutes to under 5. The alternative—manual CSV exports—breaks down when clients want mid-month check-ins or custom date ranges.

Content team board cleanup sprint

When Delete Board and Delete Pin justify the MCP for one-time audits

A 10-person media company accumulated 200+ Pinterest boards over 4 years and needs to archive outdated content before a rebrand. The Pinterest MCP's Delete Board and Delete Pin tools let the team script the cleanup based on board age or engagement thresholds instead of clicking through the web UI for days. The 24-tool scope includes Get Board for filtering and Delete Board Section for granular pruning. The trade-off: if this is truly a one-time project, the OAuth2 setup and MCP learning curve might cost more than just hiring a VA to click through the boards. This MCP pays off when the cleanup is recurring—quarterly audits, seasonal board rotations, or compliance-driven purges. If your content calendar has a 6-month shelf life and you're deleting 50+ boards per quarter, script it once in Switchy and rerun it every cycle.

Frequently asked

What can the Pinterest MCP do in Switchy?

It lets your team create, edit, and delete Pins and boards directly from Switchy's AI workspace. You can pull analytics, manage board sections, and work with both public and secret boards. The MCP wraps Pinterest's full API, so anything you'd do in the Pinterest dashboard—except ads—works here.

Do I need Pinterest Standard access to create Pins?

Yes. Trial-tier Pinterest apps are explicitly blocked from creating Pins in production. You'll need to upgrade your Pinterest app to Standard access before the Create Pin tool works outside of sandbox mode. Reading boards and analytics works fine on Trial.

Can the Pinterest MCP schedule Pins for later?

No. The MCP creates Pins immediately when you run the tool. If you need scheduling, use Pinterest's native scheduler or a third-party tool like Later. The MCP is best for bulk Pin creation or programmatic workflows where timing isn't critical.

How is this different from using Pinterest's web dashboard?

The MCP lets you script repetitive tasks—like creating 50 Pins from a spreadsheet or pulling analytics into a report—without clicking through Pinterest's UI. It's faster for bulk operations and integrates with Switchy's other tools, but the dashboard is still easier for one-off visual edits.

Who on my team should connect the Pinterest account?

Whoever owns your Pinterest business account or has admin access to the app credentials. The OAuth flow requires boards:read at minimum; creating Pins or secret boards needs boards:write and boards:write_secret. One connection covers the whole Switchy workspace.

More other MCPs

See all other MCPs →

Data last verified 61 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.