Skip to main content
Glama
clugtu

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: Boards & Pins MCP Server

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

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
ResponsivenessNo issues

Resources

Related MCP Connectors

  • AIsa PinterestAOAuth
    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
    91
  • pinbridge
    io.pinbridge

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

    Social MediaMarketing
    1
  • SocialRobot MCP ServerA
    io.socialrobot

    Schedule and publish social posts across 9 platforms (Instagram, LinkedIn, X, TikTok, Facebook, Threads, Pinterest, Bluesky, Mastodon) straight from Claude, ChatGPT, Cursor, or any MCP client. Create, edit, and reschedule posts, upload media, and pull account and post analytics, follower demographics, and best-time windows. 20 tools, free on every plan.

    Social Media
    201
  • MetrifyrOAuth
    cloud.metrifyr

    SEO & marketing toolkit for AI agents: GA4, Search Console, AdSense, GTM, PageSpeed, Trends.

    MonitoringSearchMarketing
    2

Related MCP Servers

  • Glowe Pinterest MCP

    abdouldotdev
    F
    license
    Not graded
    quality
    C
    maintenance
    Enables AI agents to search public Pinterest pins, retrieve pin metadata and media URLs, and download matching images, GIFs, or videos into a local folder, with read-only tools and explicit confirmation for downloads.
    -

  • 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