Pinterest MCP Server

Q: Can it choose the Pinterest board?

Yes. Pass the board's ID as boardId. If you don't, the pin goes to the account's default board, and if there isn't one, PostOnce creates a board named "PostOnce". The server can't create or rename boards for you, and it doesn't list your boards, so keep your board IDs handy or move pins in Pinterest afterward.

Q: Can it add a link to my pins?

Yes. Set link in platform_options to any http or https URL. The link is optional.

Your AI agent publishes and schedules pins with titles, descriptions and links through Pinterest's official API.

Start free trial Connect your agent

No credit card
3 min setup

Updated Nov 5, 2026

Connect in a minute

In Claude, open Customize → Connectors → Add custom connector and paste:
Connector URL
```
https://postonce.to/mcp
```
Choose Register automatically, select Add, then Connect and sign in to PostOnce.
Ask your agent:
Prompt
```
Show my connected PostOnce accounts.
```

Claude guide →

Turn on Developer mode, then create an app in Plugins with this URL:
Server URL
```
https://postonce.to/mcp
```
Choose OAuth with automatic registration and sign in to PostOnce.
Ask your agent:
Prompt
```
Show my connected PostOnce accounts.
```

ChatGPT guide →

Install the plugin. It adds the server and the skills below.

Terminal

claude plugin marketplace add postoncehq/plugins
claude plugin install pinterest-mcp@postoncehq

Run /mcp, pick the postonce server, choose Authenticate and sign in to PostOnce.
Ask your agent:
Prompt
```
Show my connected PostOnce accounts.
```

Claude Code guide →

Add the server:

Terminal

codex mcp add postonce --url https://postonce.to/mcp

Sign in to PostOnce in the browser that opens:
Terminal
```
codex mcp login postonce
```
Ask your agent:
Prompt
```
Show my connected PostOnce accounts.
```

Codex guide →

Merge into ~/.cursor/mcp.json:

~/.cursor/mcp.json

{
  "mcpServers": {
    "postonce": {
      "url": "https://postonce.to/mcp"
    }
  }
}

In Cursor Settings → MCP, select Connect next to postonce and sign in to PostOnce.
Ask your agent:
Prompt
```
Show my connected PostOnce accounts.
```

Cursor guide →

Add a remote server:

Connection

URL: https://postonce.to/mcp
Transport: Streamable HTTP
Auth: OAuth (sign in with PostOnce)

No OAuth in your client? Send Authorization: Bearer with a key from Preferences → API keys (paid plans only).
Ask your agent:
Prompt
```
Show my connected PostOnce accounts.
```

All integrations →

What your agent can do

Ask your agent toHow it works

Publish an image pin nowcreate_upload_url, upload, then create_post with media

Schedule a pin for latercreate_post with publish_at

Post a carousel (up to 5 images) or a video pin (4 seconds to 5 minutes)Pass the images in order, or one video, as media

Set the pin title, description and destination linktitle and link in platform_options; the post text becomes the description (up to 500 characters)

Pick the boardboardId in platform_options. Without it, the pin goes to the account's default board, or a board named "PostOnce" that's created for you

Save a draft to finish latercreate_draft

Check whether a pin went out, and get its URLget_post

Change or cancel a scheduled pinupdate_post, cancel_post

Post the same thing to Pinterest and other platformsAdd more targets to create_post (Instagram, TikTok, YouTube, LinkedIn, X, Threads, Facebook, Bluesky)

Every pin needs an image or a video; text-only pins aren't possible. Not supported: alt text, Idea Pins, board sections, creating or renaming boards, analytics, comments, and editing or deleting pins that are already live. This server publishes; it doesn't browse Pinterest for you.

Pinterest skills

Your agent writes for the platform before it posts. In the plugin, free on GitHub.

pinterest-pin-description-generatorWrites keyword-led pin titles (up to 100 characters) and descriptions (up to 500) that match what people search on Pinterest.
pinterest-seo-keywordsBuilds a keyword set for your niche and maps it to boards, titles and descriptions.
pinterest-board-ideasSuggests searchable board names and descriptions for your niche. You create the boards in Pinterest.
pinterest-pin-makerDesigns 1000×1500 (2:3) pin images with a readable text overlay, rendered from HTML to PNG.
pinterest-blog-to-pinsTurns one blog post URL into 5–10 fresh pins with different images and titles, scheduled over several weeks and linked to the post.
pinterest-content-calendarPlans 1–4 weeks of pins from your goals or a source, drafts each one and schedules them on approval.
postoncePublishing workflow: pick the right account, upload media, schedule, and confirm the pin actually went live.

pinterest-mcp on GitHub

Try these prompts

Turn this blog post into 6 fresh pins linked to it and spread them over the next 4 weeks.
Write a keyword-rich title and description for this pin and post it with a link to our product page.
Post this video as a pin with a link to the recipe.

Pinterest MCP questions

Does Pinterest have an official MCP server?

This server uses Pinterest's official API through PostOnce. Your agent publishes through the permissions you grant when you connect, not through a browser or a scraped endpoint.

Can Claude post to Pinterest?

Yes, once it's connected to an MCP server that can publish, like this one. Claude writes the pin, uploads the image and calls create_post.

Is it safe for my Pinterest account?

Yes. Pins go through Pinterest's official API with the permissions you grant when you connect. Many Pinterest MCP servers on GitHub drive a logged-in browser session or an unofficial, scraped API instead, which Pinterest's terms don't allow and which can get accounts restricted.

Can it choose the Pinterest board?

Yes. Pass the board's ID as boardId. If you don't, the pin goes to the account's default board, and if there isn't one, PostOnce creates a board named "PostOnce". The server can't create or rename boards for you, and it doesn't list your boards, so keep your board IDs handy or move pins in Pinterest afterward.

Can it add a link to my pins?

Yes. Set link in platform_options to any http or https URL. The link is optional.

Do I need a Pinterest developer app or API approval?

No. PostOnce holds the Pinterest API access; you just connect your account.

Is it free?

The skills are free and MIT-licensed on GitHub. Publishing runs through a PostOnce account, which you can try free for 7 days without entering a card. After that, see pricing.

Can I post to Pinterest from my own code?

Yes. The same publishing works through the PostOnce social media posting API with an API key on any paid plan.

More MCP servers

All tools and clients →

Your agent on Pinterest

Join 4,500+ users who post once and publish everywhere.

Start free trial

No credit card
3 min setup

Then $0.64/day, billed yearly