Skip to main content
Glama
Sign In
pinterest-mcp

pinterest-mcp

by clugtu
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

pinterest-mcp

An MCP (Model Context Protocol) server for the Pinterest API v5.

Create pins, manage boards, and track analytics — all from an AI agent.

First open-source Pinterest MCP server.

Features

Tool

Description

create_pin

Create a new Pin with image, title, description, and link

update_pin

Edit an existing pin’s metadata

delete_pin

Remove a pin

get_pin_analytics

Impressions, saves, link clicks, engagement rate

list_boards

List your boards

create_board

Create a new board

get_board_pins

List all pins on a board

search_pins

Search public pins by keyword

get_account_analytics

Account-level metrics: impressions, saves, engagements

bulk_create_pins

Create multiple pins in one call (rate-limited)

get_trending

Trending searches and interests in a niche

Related MCP server: pinterest-mcp

Installation

pip install pinterest-mcp

Or run directly with uvx:

uvx pinterest-mcp

Authentication

Pinterest uses OAuth 2.0. You need a Pinterest Business account and a registered app.

  1. Create an app at developers.pinterest.com

  2. Add redirect URI: http://localhost:8089/callback

  3. Copy Client ID + Client Secret to .env (see .env.template)

  4. Run the auth flow to generate your access token:

pinterest-mcp-auth

This opens a browser, asks you to authorize, and saves your token to .pinterest_token.json.

MCP Client Setup

{
  "mcpServers": {
    "pinterest": {
      "command": "uvx",
      "args": ["pinterest-mcp"],
      "env": {
        "PINTEREST_CLIENT_ID": "your_client_id",
        "PINTEREST_CLIENT_SECRET": "your_client_secret",
        "PINTEREST_ACCESS_TOKEN": "your_access_token"
      }
    }
  }
}

Rate Limits

Pinterest API v5 rate limits for organic posting:

  • 10 pins per minute per account

  • 250 pins per day per account

bulk_create_pins automatically respects the per-minute limit.

Development

git clone https://github.com/clugtu/pinterest-mcp
cd pinterest-mcp
pip install -e ".[dev]"
pre-commit install
pytest

This repo uses pre-commit with ruff for linting and formatting. Install pre-commit if you don't have it:

pip install pre-commit

Then run pre-commit install once to register the hooks — they'll run automatically on every git commit.

License

MIT — see LICENSE

Related

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Resources

    Related MCP Connectors

    • AIsa PinterestA
      one.aisa

      Your agent needs Pinterest as a demand signal — what people are saving in a category, which pins earn engagement, what a competitor's boards are collecting. **What you can ask for** • "What pins come up for 'home office setup', and which get saved most?" • "Page through this board and list the products it links to." • "Which boards does this user keep, and what are they about?" • "Show the engagement on this pin." **How to use it** Point any MCP client at https://mcp.aisa.one/pinterest/mcp and sign in with OAuth — there is no key to create or paste. 4 read tools: search pins, read one pin and its engagement, page through a board, and list a user's boards. **It is also a door to the rest** The same login reaches 26 sources and 580+ operations. Spot the trend here, then ask the same agent for search volume on the same phrase or who already ranks for it — without adding a second server. **What it costs** Finding and inspecting an operation is free. Running one is billed per call at API prices, with no seat and no monthly minimum, and every call takes max_price_usd so an agent cannot overspend by accident. **Where else it reaches** https://mcp.aisa.one/social/mcp for X plus Instagram, Reddit, Pinterest and YouTube; https://mcp.aisa.one/gtm/mcp for those plus Similarweb and Apollo.

      SearchSocial Media
      111
      https://mcp.aisa.one/pinterest/mcp?from=glama
    • 365 Pinterest
      com.365pinterest

      Pinterest automation: schedule pins, manage boards, write AI blogs and auto-pin them.

      1
      https://365pinterest.com/mcp
    • pinbridgeA
      io.pinbridge

      Publish and schedule Pinterest pins from any MCP client. Token refresh and retries handled.

      Social MediaMarketing
      341
      https://mcp.pinbridge.io
    • PinBuilds
      com.pinbuilds

      Create Pinterest pins from blog posts and Shopify/Etsy products, and schedule them to your boards.

      Social MediaE-commerce & RetailMarketing
      1
      https://pinbuilds.com/api/mcp

    Related MCP Servers

    • pinterest-mcp

      Yes526-tech
      A
      license
      A
      quality
      C
      maintenance
      Enables AI agents to manage Pinterest accounts through the Pinterest API v5, including creating and editing pins, organizing boards, searching public content, and retrieving pin and account analytics.
      11
      MIT

    • pinterest-mcp-server

      N-Graves
      A
      license
      B
      quality
      C
      maintenance
      Enables interaction with the Pinterest API v5 through natural language, covering 263 operations including pins, boards, analytics, and advertising tools, with configurable read-only and non-destructive modes.
      8
      14 npm
      MIT

    • pinterest-mcp

      aymandakirgh
      A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to read and manage an account's boards, pins, sections, and analytics, run full-text search over its own content, and complete OAuth token flows through the Pinterest API v5. It exposes 35 typed tools that run either as a local stdio subprocess or as a stateless remote HTTP endpoint with built-in OAuth 2.1 support.
      35
      31 npm
      2
      MIT