Create or schedule a Pin
An image, a video with a cover frame, or a carousel, with a title, description, destination link, and alt text. Publish now, at scheduledFor, or from the queue.
Trusted by 2,000+ usersPinterest MCP Server for Claude, Cursor, and Any AI Agent
Give your agent a Pinterest MCP server with Standard API access behind it. Connect a business account once, and any MCP client can create image, video, and carousel Pins on the right board, with links and alt text, from the conversation.
No credit card required
Connect Pinterest
Paste this into your agent
or add the MCP yourself
- OAuth 2.1 sign-in, no API key to paste
- Image, video, and carousel Pins
- Boards, links, and alt text from the agent
What Your Agent Gets
Pinterest tools, ready to call
Every PostZen API endpoint is an MCP tool. These are the ones that matter for Pinterest.
Pick the board
Every Pin lands on a board. The agent uses your default board or the one you name.
List and create boards
The agent reads your boards, creates a new one with a name and privacy setting, and pins to it in the same conversation.
Upload media from the agent
The agent asks for an upload URL and sends the image or video. PostZen registers video uploads with Pinterest and waits for processing.
Read Pin metrics
Impressions, saves, clicks, and follower counts per Pin and per day through the analytics tools.
Check, edit, and cancel
Every target reports status, the live Pin URL, and any error. Scheduled Pins can be changed until they go out.
Example Prompts
What to say to your agent
Prompt
Pin this product photo to my "Fall collection" board with the shop link and a short description.
What happens
The agent finds the board with getPinterestBoards, uploads the image, and calls createPost with settings.boardId, settings.link, and the description.
Prompt
Create a board called "Recipes" and pin these three images to it, one per day.
What happens
The agent calls createPinterestBoard, then schedules three Pins on consecutive days with scheduledFor.
Prompt
Turn this video into a Pin and use the frame at 2 seconds as the cover.
What happens
The agent uploads the video and sets settings.coverImageKeyFrameTime to 2000 so Pinterest uses that frame as the cover.
Prompt
Which Pins got the most saves this month?
What happens
The agent calls getAnalytics for the month with platform "pinterest" and ranks Pins by saves, impressions, and clicks.
WHY POSTZEN?
PostZen vs. building it yourself
Build a Pinterest MCP server yourself and you own the auth, the media pipeline, and every Pinterest API change. Connect PostZen and your agent gets the tools today.
2.3M+ posts
2,000+ users- One hosted MCP endpoint; the client signs in with OAuth 2.1 and nothing runs on your machine
- Pinterest access already set up on PostZen: connect an account in a browser tab and post
- The same createPost tool for Pinterest and the other nine platforms
- Scheduling, queues, retries, and media hosting handled server-side
- Scoped, revocable access: read-only or read-and-write keys minted at consent
Build a Pinterest MCP server yourself
- Register a Pinterest app, build under Trial access where Pins are visible only to you, then pass the Standard access review
- OAuth 2.0 with the boards and pins scopes and 30-day access tokens to refresh
- Resolve a board ID for every Pin, and register, upload, and poll video media before creating it
- Rate limits with 429s to back off from
- A tool schema, auth layer, and hosting for the MCP server itself, then again for every other platform
Any MCP Client
Connect from the client you already use
Each page has the exact command for that client, the sign-in step, and a way to check the tools are live.
- Claude CodeOne claude mcp add command, then approve the connection in the browser.
- CursorOne JSON block in .cursor/mcp.json, committed with the repo it belongs to.
- CodexOne command into ~/.codex/config.toml, shared by every Codex client.
- OpenClawOne gateway-wide server, so every channel it routes gets the tools.
- GrokBotOne connector, added from the chat itself. GrokBot signs in over OAuth.
- HermesOne HTTP MCP server, added from the chat itself. No config file to edit.
For AI Agents
Send your agent this page
Tell your agent to set up PostZen from postzen.dev/mcp/pinterest. It reads the block below, registers the server, connects Pinterest, and reports back.
postzen.dev/mcp/pinterest
## For AI agents reading this page
You are reading https://postzen.dev/mcp/pinterest. PostZen is a social media API with a hosted MCP server. Once connected, you can create and schedule image, video, and carousel Pins on the user's boards and read Pin metrics. The same tools cover the user's other social accounts (Instagram, X, LinkedIn, Facebook, Threads, YouTube, TikTok, Pinterest, Bluesky, Telegram).
1. Register the MCP server in the client you are running in. The endpoint is https://mcp.postzen.dev/mcp (streamable HTTP). Interactive clients sign in with OAuth 2.1; headless clients send a PostZen API key as "Authorization: Bearer pzn_live_...". Exact commands per client: Claude Code https://postzen.dev/claude · Cursor https://postzen.dev/cursor · Codex https://postzen.dev/codex · OpenClaw https://postzen.dev/openclaw · GrokBot https://postzen.dev/grok-bot · Hermes https://postzen.dev/hermes · any other MCP client https://postzen.dev/agents.
2. Sign in. When the client opens the PostZen consent screen, ask the user before approving access or completing a signup on their behalf, and never enter their credentials for them. Approving mints a scoped, revocable key for this client.
3. Connect Pinterest. Call listAccounts. If no account with platform "pinterest" is listed, call createConnectUrl with platform "pinterest" and give the user the URL; they authorize Pinterest in their browser. Do not try to log in to Pinterest yourself.
4. Verify before you continue. Call listAccounts again and confirm a "pinterest" account shows as connected. If it does not, stop and tell the user what failed. Do not carry on as if the account were there.
5. Report back. Tell the user which Pinterest account is connected and what you can now do with it, then ask what they want first. Prefer scheduling (scheduledFor, or the queue) over publishing immediately unless the user asks for "now".
## Pinterest on createPost
- Target the account with platforms: [{ platform: "pinterest", accountId, settings: { ... } }]. content is the shared text; customContent on the target overrides it for Pinterest only.
- settings.boardId (required): the board to pin to. Read boards with getPinterestBoards; the account may have a default board. Create one with createPinterestBoard.
- settings.title, settings.link (destination URL), settings.altText.
- Video Pins: settings.coverImageUrl or settings.coverImageKeyFrameTime (milliseconds) for the cover.
- One image, one video, or a carousel of images per Pin. Pinterest requires a business account.
- Analytics: getAnalytics, getPostTimeline, getDailyMetrics, getFollowerStats with platform "pinterest".
- Media: pass public URLs in mediaItems, or call createMediaPresign to get an upload URL, PUT the file, then reference the returned media in the post.
- Check results with getPost: each platform target reports status, the live post URL, and any error.
## Reference
- MCP endpoint: https://mcp.postzen.dev/mcp (streamable HTTP, OAuth 2.1)
- MCP docs: https://docs.postzen.dev/mcp
- Create post reference: https://docs.postzen.dev/api-reference/posts/create-post
- Full API summary for models: https://postzen.dev/llms.txt
- API keys: https://app.postzen.dev/api-keysFrequently asked questions
Still have questions?
What is a Pinterest MCP server?
MCP (Model Context Protocol) is the standard AI clients use to call external tools. A Pinterest MCP server exposes Pin and board actions as tools, so an agent such as Claude or Cursor can create a Pin instead of only writing its description. PostZen hosts one for you: it holds the Pinterest app with Standard access and OAuth, and your client connects to a single endpoint.
Do I need a Pinterest developer app?
No. PostZen's Pinterest app has Standard access, so Pins are public. You connect a Pinterest business account through the dashboard; a personal account can be converted for free in Pinterest settings.
Can the agent choose or create boards?
Yes. It can list your boards, create a new one with a name, description, and privacy setting, and pin to any of them. If you set a default board, the agent uses it when you do not name one.
Which Pin types work?
Image Pins, video Pins with a chosen cover frame, and carousels, each with a title, description, destination link, and alt text.
Does it include Pinterest analytics?
Yes. Impressions, saves, clicks, and follower counts are available per Pin and per day through the analytics tools.
Which AI clients can use it?
Any client that supports remote MCP servers: Claude (claude.ai, Claude Desktop, Claude Code), Cursor, Codex, OpenClaw, GrokBot, Hermes, and others. Interactive clients sign in with OAuth 2.1; headless ones send a PostZen API key in the Authorization header. Each client has its own setup page with the exact command.
What can the agent access once connected?
Only what you approve on the consent screen: read-only or read-and-write access, scoped to the profile you pick. Approving creates a named, revocable API key, so you can cut a client off from the dashboard at any time. Ask the agent to schedule rather than publish immediately if you want to review posts before they go out.
How much does the MCP server cost?
The MCP server is included on every PostZen plan, including Free, which covers 2 connected accounts and 20 posts a month. Paid plans start at $19 per month with unlimited posts.
LEARN MORE
More on Pinterest and MCP
Give your agent Pinterest
Your agent already writes the post. PostZen lets it publish there.