Skip to content
Download Longwave

Pinterest

Pinterest is an MCP server for Pinterest boards, pins and publishing. Its connected endpoint exposes 3 tools after authorization.

Add to Longwave

Install elsewhere

Install Pinterest

Choose a harness. These instructions connect to the hosted MCP endpoint shown on this page.

Claude Code

Run this in your terminal. It adds a user-scoped server; use --scope project instead if it should apply only to the current project.

terminal
claude mcp add --scope user --transport http pinterest https://api.longwave.run/v1/mcp/pinterest

What it does

Pinterest MCP gives an agent access to the boards and pins behind a content workflow. It can inspect existing account content before creating a new pin.

  • Read Pinterest boards and pins.
  • Create a pin from a public image URL.
  • Set a destination link, title, and description.
  • Keep Pinterest sign-in in the hosted connection.

Available functions

longwave_pinterest_browse Read Pinterest: list boards, list pins on a board, or fetch one pin. Does not create or modify content.

Arguments

accountId
string Exact account id from longwave_list_accounts. Omit only when a single account is connected.
action required
boards = list boards; board_pins = list pins on a board; pin = fetch one pin by id.
boardId
string Board id (required for board_pins).
limit
number Max items to return (1–100). Default 25.
pinId
string Pin id (required for pin).
longwave_pinterest_identity Return the connected Pinterest account identity (/v5/user_account). Use after connect or to confirm which account is active.

Arguments

accountId
string Exact account id from longwave_list_accounts. Omit only when a single account is connected.
longwave_pinterest_submit Write to Pinterest: create a pin on a board from a public image URL. Requires a connected Pinterest account with pins:write.

Arguments

accountId
string Exact account id from longwave_list_accounts. Omit only when a single account is connected.
boardId required
string Board id to create the pin on.
description
string Pin description.
imageUrl required
string Public image URL used as the pin media source.
link
string Destination link for the pin.
title
string Pin title.

Questions people ask

Does Pinterest MCP need an API key?

Not in Longwave. Longwave uses Pinterest sign-in.

  1. Click Add to Longwave on this page.
  2. Sign in to Pinterest when Longwave asks.
  3. Start a thread and pick a harness.
How do I use Pinterest MCP with Claude Code?

Claude Code can list Pinterest boards or create pins.

  1. Click Add to Longwave on this page.
  2. Sign in to Pinterest when Longwave asks.
  3. Start a thread and pick Claude Code.
  4. Ask Claude Code to list your boards or create a pin.
How do I use Pinterest MCP in Cursor?

Cursor can list Pinterest boards or create pins.

  1. Click Add to Longwave on this page.
  2. Sign in to Pinterest when Longwave asks.
  3. Start a thread and pick Cursor.
  4. Ask Cursor to list your boards or create a pin.
Can the pin include a destination link back to my site?

Yes. A pin can include a public image URL, a board, a destination link, a title, and a description.

  1. Choose the board.
  2. Provide a public image URL.
  3. Provide the destination link.
  4. Add a title and description when needed.
Can the agent list my boards, pick one, and pin in the same thread?

Yes. Pinterest can list boards before it creates a pin.

  1. Ask the agent to list your boards.
  2. Choose a board ID.
  3. Provide the image URL and destination link.
  4. Ask the agent to create the pin.
Why does a localhost or signed image URL fail?

Pinterest fetches the image itself, so the image URL must be public.

  1. Upload the image to a public host.
  2. Copy the public image URL.
  3. Give the URL to the agent.
Can it create a Pinterest board?

Yes. Use Playwright in Longwave to create a Pinterest board through the signed-in Pinterest website. Pinterest MCP then creates pins on the board.

  1. Add Playwright to Longwave.
  2. Start a thread and pick a harness.
  3. Ask Playwright to open Pinterest and complete sign-in.
  4. Ask the agent to create the board.
  5. Ask Pinterest MCP to create a pin on the new board.
Can it pin to someone else's board?

Yes. Use Playwright in Longwave when your Pinterest account can access the shared board. Pinterest MCP uses the boards returned for the signed-in account.

  1. Confirm that your Pinterest account can access the shared board.
  2. Add Playwright to Longwave.
  3. Start a thread and pick a harness.
  4. Ask the agent to open the shared board and create the pin.
Is this a Pinterest downloader?

Yes. Use Playwright in Longwave to open a public Pin and download media when Pinterest makes the file available. Pinterest MCP manages your boards and pins.

  1. Add Playwright to Longwave.
  2. Start a thread and pick a harness.
  3. Give the agent the public Pin URL.
  4. Ask it to open the Pin and save the available media in the current Space.
Can it publish video pins or run ads?

Yes. Use Playwright in Longwave to publish video pins or manage ads through the signed-in Pinterest website. This listing creates still pins from public image URLs.

  1. Add Playwright to Longwave.
  2. Start a thread and pick a harness.
  3. Ask Playwright to open Pinterest and complete sign-in.
  4. Give the agent the video or campaign details.
  5. Review the content or campaign before publishing it.

Give the agent the board before the pin.

Let it inspect the existing account context before it publishes another piece of content.