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

Related MCP server: pinterest-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

• cults3d-mcp — Cults3D marketplace MCP server