# Pinterest MCP > Pinterest MCP Server lets your AI agent manage all visual content on Pinterest. Use it to list every board and audit pins across your entire account, making manual curation obsolete. You can create new boards (`create_board`), publish fresh Pins with titles and links (`create_pin`), or delete old content using `delete_pin` and `delete_board`. It gives you total control over your visual catalog without ever touching the dashboard. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** visual-discovery, content-curation, social-media-marketing, board-management, pin-automation, creative-inspiration ## Description You wanna manage your Pinterest visual content without logging in? This server lets your AI agent take over everything on your profile. Forget manually clicking through boards or auditing pins—you just tell your client what you need, and it does the heavy lifting. **`list_boards`** gives you a full list of every board you own. If you know which board you're talking about, **`get_board`** pulls all the details and metadata for that specific board using its unique ID. You can also pull all the pins contained within any given board by calling **`list_pins`**, and if you need to check a single pin's full data, **`get_pin`** handles that. Need to publish some new stuff? You can use **`create_board`** to set up an empty board right away. To push out fresh content, **`create_pin`** publishes a brand-new Pin; it requires you to feed it a title, description, and the source link for where that Pin comes from. And when it's time to clean house? You can permanently yank an entire board off your account with **`delete_board`**. If you only wanna ditch one piece of content, **`delete_pin`** removes a single pin by its ID. These tools give you total command over your visual catalog. For governance checks or just to know what's up with the account itself, **`get_me`** pulls detailed information about your connected Pinterest user profile. It’s how you audit the core data of the account. This setup lets your agent handle every read and write operation—it’s essentially a complete CRUD suite for all your visual assets on Pinterest. You don't need to mess around with the dashboard anymore. You just tell your AI client what needs changing, whether it's listing out everything you have or publishing three new pins at once. It translates that request into tool calls and makes it happen against Pinterest’s API. ## Tools ### create_board Creates a new, empty board for your account. ### create_pin Publishes a new pin to Pinterest, requiring a title, description, and source link. ### delete_board Permanently removes an entire board from your account. ### delete_pin Removes a single pin you specify by its ID. ### get_board Retrieves the full details and metadata for one specific board. ### get_me Gets core information about your authenticated Pinterest user account. ### get_pin Retrieves the full details and metadata for one specific pin. ### list_boards Lists all boards you own on your account. ### list_pins Lists pins, with an option to filter by a specific board ID. ## Prompt Examples **Prompt:** ``` List all my Pinterest boards. ``` **Response:** ``` I've retrieved your boards. You have 5 active boards, including 'Home Decor' and 'Travel Goals'. Which one would you like to audit for pins? ``` **Prompt:** ``` Create a new pin in 'Travel Goals' titled 'Summer in Italy'. ``` **Response:** ``` Pin created! 'Summer in Italy' is now live on your 'Travel Goals' board. I've recorded the pin ID for your audit. ``` **Prompt:** ``` Show me the pins in my 'Home Decor' board. ``` **Response:** ``` I've found 12 pins in that board. Notable entries include 'Modern Kitchen' and 'Minimalist Living Room'. Would you like the links for any of them? ``` ## Capabilities ### List all existing boards Retrieves a list of every board associated with your account. ### Get specific board details Fetches the full metadata for one board using its unique ID. ### Publish new Pins Creates and publishes a brand-new Pin, allowing you to define the title, description, and destination link. ### Search pins within a board Lists all the pins currently contained in a specific board ID for review. ### Automate content removal Deletes either an entire board or individual pins directly, keeping your visual library clean. ### Audit user account data Pulls detailed information about the connected Pinterest user profile for governance checks. ## Use Cases ### Auditing a client’s entire visual library A marketing team needs to check if a new product line has been correctly pinned across 50 different boards. Instead of visiting each board, they ask their agent to run `list_boards` first, then loop through the results using `list_pins` for each one. The agent aggregates all pin data, confirming every required pin is in place. ### Automating content cleanup The operations lead discovers that 20 boards are outdated because they contain irrelevant pins. They tell their agent to run `list_boards` and then use the board IDs to trigger a mass deletion via `delete_board`, cleaning up hundreds of orphaned assets in minutes. ### Generating new campaign ideas A visual creator wants to publish a series of mood boards. They ask their agent to `create_board` for 'Summer Vibes 24' and then use `create_pin` multiple times, supplying the title and link for each photo asset, all from a single chat prompt. ### Verifying account status Before handing off accounts to an agency, the project manager needs proof of ownership. They run `get_me` to pull detailed user account information and verify that all necessary contact fields are populated and accurate. ## Benefits - Stop manually listing content. Use `list_boards` to get a complete inventory of every board you own in one call, giving you immediate oversight into your full creative catalog. - Never lose track of an asset again. Running `get_pin` or `get_board` gives you all the specific metadata—descriptions, IDs, links—you need for auditing purposes. - Publish content instantly with `create_pin`. You just tell your agent the title and link; it handles the actual pinning process without you touching the site. - Keep things clean. If a board or pin is dead weight, use `delete_board` or `delete_pin` to automate cleanup tasks across thousands of assets. - Track who's in charge. The `get_me` tool pulls your core account details, letting you run governance checks and ensure your connected profile data is always accurate. ## How It Works The bottom line is: you give the server an access token, and your AI client handles all the API calls to manage your visual assets. 1. Subscribe to this server and enter your Pinterest Access Token. 2. Tell your AI client what you need done (e.g., 'List all my boards and find the ID for the Travel Goals board'). 3. The agent runs the necessary tools, fetching data or making changes directly on Pinterest. ## Frequently Asked Questions **How do I list all my Pinterest boards using `list_boards`?** You simply ask your agent to run the `list_boards` tool. The output will give you a complete, structured list of every board name and its unique ID. **Can I delete pins in bulk with `delete_pin`?** `delete_pin` only removes one pin at a time. To clear out multiple pins, first use `list_pins` to gather all the necessary Pin IDs, and then ask your agent to run `delete_pin` for each ID. **What do I need to know before using `create_pin`?** You must supply three things: a title, a description, and the destination URL. The tool uses these inputs to publish the pin correctly on Pinterest. **Does `get_board` give me all board metadata?** Yes, running `get_board` retrieves detailed metadata for that specific board ID, including its description and creation details. This is better than just listing it. **How do I verify my account details after connecting using `get_me`?** It returns basic user metadata, confirming your connection scope and ownership info. This is necessary to ensure your agent operates only on the intended Pinterest profile. **Can I use `list_pins` to filter for content within a specific board ID?** Yes, you pass the Board ID as an optional parameter when calling list_pins. This narrows down results immediately, letting your AI client audit only one board without listing all pins. **What happens if I try to use `create_board` too frequently?** The server manages standard API rate limits for you. If you exceed the allowed calls, your AI client will receive a specific error code indicating when you can safely retry the operation. **What detailed information does `get_pin` provide about a single pin?** It returns rich, granular details on the pin itself. You get the title, description, source link, and associated board ID—everything you need for deep auditing or content repurposing. **How do I find my Pinterest Access Token?** Go to the [**Pinterest App Console**](https://developers.pinterest.com/apps/), create an App, and generate a token with the necessary scopes (boards:read, pins:read, pins:write, etc.). Copy and paste it below. **Can the agent create new boards?** Yes. Use the `create_board` tool providing a name and optional description. Your agent will create the board and return its unique ID instantly. **Is it possible to pin from an image URL?** Yes. The `create_pin` tool requires a `media_source_url`. Your agent will use this URL to generate the pin on your target board.