# Pinterest MCP server > Connect Claude, ChatGPT or Cursor to Pinterest. Your agent pins to the board you name with a title, link and alt text, and reads how each Pin did. Canonical: https://omnisocials.com/pinterest-mcp | Channel page: https://omnisocials.com/pinterest.md | Pinterest API: https://omnisocials.com/pinterest-api.md | Pricing: https://omnisocials.com/pricing.md | 14-day free trial: https://app.omnisocials.com/signup This is the machine-readable version of [omnisocials.com/pinterest-mcp](https://omnisocials.com/pinterest-mcp), maintained for AI agents. Facts checked against the OmniSocials app on October 16, 2026. - **Server URL:** https://mcp.omnisocials.com - **Auth:** OAuth sign-in, or an API key for agents that run on their own - **Discovery file:** https://omnisocials.com/.well-known/mcp.json - **Docs:** https://docs.omnisocials.com/mcp-server - **With your AI agent:** Connect Claude, ChatGPT or any MCP client to Pinterest with the OmniSocials MCP server. Your agent pins to the board you name, with a title, link and alt text, and reads your numbers, through Pinterest's official API. - **With your coding agent:** Claude Code and Codex add the OmniSocials MCP server with one command, and agents that run on their own use an API key. Or call the Pinterest API from your own code. ## What your agent does Ask in plain words. Your agent picks the MCP server's tools and fills in what a Pin can carry. - **Pin to the board you name.** Your agent reads your boards and adds the title, the link and the alt text. (`create_post`, `get_account`) - **Carousel Pins of 2 to 5 images.** Images of one shape go out as one Pin people swipe. (`create_post`, `upload_media`) - **Know what worked.** Your best Pin, its numbers and the best time to post the next one. (`get_posts_analytics`, `get_best_times`) ## Setup Connected in a minute. One URL and one sign-in. No API key for chat apps. 1. **Connect Pinterest in OmniSocials.** Sign in with Pinterest once. Your boards load with it. 2. **Add the server to your agent.** Paste one URL as a custom connector, or run one command. 3. **Sign in and pick a workspace.** OAuth in the browser. Agents that run on their own use an API key. - **Claude:** Customize > Connectors > Add custom connector > Paste the URL. Claude sends you to OmniSocials to sign in. No API key needed. Guide: https://omnisocials.com/claude - **Claude Code:** `claude mcp add --transport http omnisocials https://mcp.omnisocials.com`. Then type /mcp in Claude Code and sign in to OmniSocials. Guide: https://omnisocials.com/claude-code - **Codex:** `codex mcp add omnisocials --url https://mcp.omnisocials.com`. Then run codex mcp login omnisocials to sign in. Guide: https://omnisocials.com/codex - **API key:** `claude mcp add --transport http omnisocials https://mcp.omnisocials.com --header "Authorization: Bearer YOUR_API_KEY"`. For agents that run on their own. Create the key in Settings, API Keys. Docs: https://docs.omnisocials.com/mcp-server ## Tools 21 tools in 5 groups. Your agent picks them from a plain request. ### Publishing Image, carousel and video Pins, now or on a schedule. Try asking: "Pin the best-times slides to Product updates Thursday at 9 AM, with a link to our changelog." - create_post: Schedule an image, carousel or video Pin on a board, with a title, link, alt text and products. - create_and_publish_post: Pin to Pinterest right away. - update_post: Change the board, title, link or time of a scheduled Pin. - upload_media: Upload images or a video from a URL or the chat. - check_media_compatibility: Check a file against Pinterest's rules first. - retry_post: Publish a failed Pin again. ### Boards and products Where a Pin goes and what people can shop on it. Try asking: "Which boards do I have, and which products can I tag?" - get_account: Your Pinterest boards with their IDs. - list_pinterest_products: Your own product Pins, from your catalog or your Pins, ready to tag. - list_accounts: The accounts connected to the workspace. ### Insights What each Pin did, and when to post the next one. Try asking: "Which Pin did best last month, and when should I post next?" - get_post_analytics: The numbers Pinterest reports for one Pin, saves and clicks included. - get_posts_analytics: Impressions and engagements for many Pins at once. - get_account_analytics: Your followers and monthly views. - get_best_times: Your best days and hours from your own Pins, or industry defaults until you have 15. - get_recent_platform_posts: Your latest Pins, also the ones made in Pinterest. ### Approvals Your team or client signs off before a Pin goes out. Try asking: "Approve the Pins that are waiting for me." - list_approval_workflows: The review steps a post can go through. - approve_post: Approve a post that waits for you. - reject_post: Send a post back with what to change. - get_post_approval: Where a post stands in its review. ### Workspace Which workspace, which images, which events. Try asking: "Which workspaces can you post to? Find our best-times images." - switch_workspace: Work in another workspace. - list_media: Find an image in your library before uploading it again. - create_webhook: Get an event when a Pin is scheduled, published, approved, rejected or fails. ## FAQ ### What is the Pinterest MCP server? It is the OmniSocials MCP server with your Pinterest account connected. Your AI agent calls its tools to pin to your boards, tag your products and read your numbers, through Pinterest's official API. The server lives at https://mcp.omnisocials.com, and the same tools post to your other channels too. ### Can my agent pick the board? Yes. get_account lists your Pinterest boards, and create_post takes the one you name. Name no board and your agent uses the first one and tells you which, so you can move the Pin. Each Pin goes to one board. New boards are made in the OmniSocials app. ### Can it post carousel and video Pins? Yes. Send 2 to 5 images of the same shape and they go out as one carousel Pin. A mix of shapes is refused when the Pin is scheduled, and the answer names the slides to fix. A video of up to 15 minutes goes out as a video Pin, with a cover image if you like. ### Can it tag products on a Pin? Yes. list_pinterest_products lists your own product Pins, from your Pinterest catalog or your Pins, and create_post tags up to 24 of them on a Pin. Only your own products can be tagged. If Pinterest refuses one, the Pin still goes out and get_post says which product wasn't tagged. ### Can it answer Pinterest comments? No. Pinterest comments don't come into the Social Inbox, so the MCP server has no comment tools for Pinterest. Your agent can read how many comments a Pin got from its analytics. ### Can it read other people's Pinterest boards? No. It works with the account you connected: your boards, your Pins, your own products and your numbers. It doesn't scrape other accounts, boards or Pins. ### How do I connect Claude, ChatGPT or Cursor to Pinterest? Connect Pinterest in OmniSocials first. In Claude, open Customize, then Connectors, click Add, choose Add custom connector and paste https://mcp.omnisocials.com. In ChatGPT, add the same URL as a custom MCP server under Plugins; in Cursor, put it in ~/.cursor/mcp.json. Each one sends you to OmniSocials to sign in and pick a workspace. ### Can an AI agent post to Pinterest safely? Yes. Your agent can send a post through an approval workflow: it waits until a teammate or client approves it, and only then goes out at its time. You can also ask your agent to save drafts, or to show you each post before it schedules it. ### Does the Pinterest MCP server need a paid plan? It needs an active OmniSocials plan or the 14-day free trial; without one, the server turns the connection down. The trial needs a card to start, and the MCP server is part of the one plan, like every other feature. ### How much does OmniSocials cost? One plan with every feature included: $10 per seat per month billed annually, or $12 billed monthly. Team members and client seats cost the same. Every account starts with a 14-day free trial. ## Related ### Set up your agent - [Claude](https://omnisocials.com/claude) - [ChatGPT](https://omnisocials.com/chatgpt) - [Claude Code](https://omnisocials.com/claude-code) - [Codex](https://omnisocials.com/codex) - [Cursor](https://omnisocials.com/cursor) - [Every agent](https://omnisocials.com/mcp) ### Pinterest - [Pinterest scheduler](https://omnisocials.com/pinterest) - [Best time to post on Pinterest](https://omnisocials.com/best-time-to-post-on-pinterest) - [Pinterest image sizes](https://omnisocials.com/pinterest-image-sizes) - [Pinterest character limits](https://omnisocials.com/pinterest-character-limits) ### For developers - [MCP server docs](https://docs.omnisocials.com/mcp-server) - [Pinterest API](https://omnisocials.com/pinterest-api) - [CLI](https://omnisocials.com/cli) ## More machine-readable pages - [Pinterest](https://omnisocials.com/pinterest.md) - [Pinterest API](https://omnisocials.com/pinterest-api.md) - [All channels](https://omnisocials.com/channels.md) - [MCP server](https://omnisocials.com/mcp.md) - [REST API](https://omnisocials.com/api.md) - [Pricing](https://omnisocials.com/pricing.md) - [llms.txt](https://omnisocials.com/llms.txt)