Pinterest Pages MCP connector

What agents can do

The server has 19 actions (12 read, 7 write).

• Account: get_user_account for profile details such as follower count and monthly views, and get_user_account_analytics for impressions, saves, pin clicks, outbound clicks and video metrics.
• Boards and sections: get_boards, get_board, get_board_sections, get_board_pins and get_board_section_pins.
• Pins: get_pins, get_pin and get_pin_analytics.
• Trends: get_trending_keywords by region, with growing, monthly, yearly or seasonal trend types.
• Publishing: create_pin, save_pin, create_board, update_board, create_board_section and update_board_section on Read + Write connections.
• Video upload: create_media and get_media_status.

Before you connect

• A Pinterest account you can sign in to.
• A brand in your InsightfulPipe workspace to attach the account to. Owners, admins and operators can add connections.

Connect Pinterest Pages

1. In the InsightfulPipe app, open Connectors, choose Pinterest Pages and click Connect.
2. Under Permissions, choose Read Only or Read + Write.
3. Sign in to Pinterest and approve every requested permission. The connection is refused if some permissions are not granted.

Add the MCP server to your AI client

Server URL: https://pinterest-pages.insightfulmcp.com/ and server name: pinterest-pages-mcp.

• Claude: open Claude Connectors Settings, scroll to the bottom and click Add custom connector, paste the URL, click Add, then click Connect.
• ChatGPT: in ChatGPT Security Settings turn on Developer mode, click Create on the Connectors page, paste the URL, click Create, then click Connect. Turn the connector on in each new chat with + → More.
• Claude Code: run claude mcp add --transport http pinterest-pages-mcp https://pinterest-pages.insightfulmcp.com/, then type /mcp, select pinterest-pages-mcp and click Authenticate.
• Cursor: in the app, open MCP Servers, choose Pinterest Pages and click Install Pinterest Pages MCP, click Open Cursor then Install, then click Connect and Open.
• Gemini CLI: run gemini mcp add --transport http pinterest-pages-mcp https://pinterest-pages.insightfulmcp.com/, then /mcp auth pinterest-pages-mcp.
• Codex CLI: run codex mcp add pinterest-pages-mcp --url https://pinterest-pages.insightfulmcp.com/; authorization starts automatically.

Each client opens a browser window where you log in to InsightfulPipe and click Authorize access. Step-by-step guides: Claude, ChatGPT, Claude Code, Cursor, Gemini CLI and Codex CLI. To reach every connected platform through one server, use the unified server.

Permissions and safety

• Read Only connections can read your account, boards and pins. Read + Write connections add permission to create pins and boards.
• There are no destructive actions: no deletes are exposed, and pins can't be edited after they are created.
• create_pin publishes the pin immediately, with no draft or schedule. Review the image, title, link and board before an agent creates one, or turn the action off in Configure actions for this account.
• Write actions need the Owner, Administrator or Operator role. Members with the User role only get the enabled read actions on accounts granted to them.

Limits

• Account and pin analytics are limited to the last 90 days. There are no board-level analytics.
• create_pin takes a public image_url, or 2 to 5 image URLs for a multi-image pin. Titles are limited to 100 characters, descriptions to 800 and alt text to 500.
• Video pins need the file uploaded to the upload URL that create_media returns, which most chat clients can't do.
• Existing pins can't be moved between sections, although save_pin can save a pin to another board or section.
• get_trending_keywords uses region US and trend type growing when you don't set them.

Example prompts

• "Using Pinterest Pages, which of my pins had the most outbound clicks in the last 30 days?"
• "How did impressions and saves trend on my account over the last 90 days?"
• "Show seasonal trending keywords in the UK."
• "Create a pin on my Recipes board with this image URL, title and link."

Troubleshooting

• "Pinterest did not grant all required permissions": reconnect and approve every permission on the Pinterest screen.
• "More than one Pinterest account matches this request. Provide the exact account_id (Pinterest user ID).": ask the agent to list your accounts first, then name the account to use.
• Pinterest returns code 29 when creating a pin: Pinterest can block pin creation for apps with Trial access. Contact [email protected] with the error text.
• "This account is connected read-only, so this action cannot be enabled for it. An owner or admin must reconnect it with Read & Write permissions.": reconnect and choose Read + Write.

FAQ

Can an agent delete my pins or boards?

No. The connector exposes no delete actions for pins, boards or sections.

How is this different from the Pinterest Ads connector?

Pinterest Pages covers your organic pins, boards, account analytics and trending keywords. The Pinterest Ads connector covers ad accounts, campaigns and ad reporting. You can connect both.

Can I connect several Pinterest accounts?

Yes. Connect each account with its own Pinterest sign-in. Each account counts as one connection on your plan.

Related

• Pinterest Pages MCP server
• Pinterest Ads connector
• Connectors overview
• Roles and permissions
• MCP troubleshooting