Pinterest API Integration · Developer Documentation
A private Model Context Protocol server that lets one person publish and measure pins on their own Pinterest business accounts through an AI assistant.
At a glance
Overview
Publishing to Pinterest well means writing keyword-led titles and descriptions, matching each pin to the right board, and then checking weeks later which of them actually earned saves and outbound clicks. Done by hand across several boards a day, that is slow and easy to get wrong.
The Love Where You Live Connector closes that loop. It is a small Node program that exposes the Pinterest REST API v5 as a set of tools an AI assistant can call, so the operator can draft a pin, publish it to their own board, and read back its performance in one continuous working session instead of three disconnected ones.
It is deliberately narrow. It publishes original images the operator created themselves, to boards the operator owns, on accounts the operator authorized. It has no interest in anyone else's data and no mechanism to reach it.
Mechanism
POST /v5/pins to create the pin on a board the operator owns, and PATCH or DELETE to correct or remove one later.
The access token expires on Pinterest's normal 30-day cycle and is refreshed automatically using the stored refresh token. Revoking the app in Pinterest settings stops every one of these steps immediately.
Permissions
| Scope | Why it is needed |
|---|---|
| boards:read | List the operator's own boards so each pin can be filed to the correct existing board. |
| boards:write | Create a board on the operator's own account when a new topic genuinely warrants one. |
| pins:read | Retrieve the operator's own pins to check what was already published and avoid near-duplicates. |
| pins:write | Create pins, and edit or delete them afterwards to fix a title, description, or destination link. |
| user_accounts:read | Confirm which account the token belongs to, and read account-level analytics for that same account. |
No scope is requested for other users' content, follower data, messaging, or advertising.
Handling
Nothing is collected from any Pinterest user. The app reads only the account that authorized it and the pins and boards on that account.
A single local file holding the OAuth access token, refresh token, app ID, and app secret. It is excluded from version control and is not backed up to any remote service. Pin images and text are read from local files at publish time and are not retained anywhere else.
Requests go to api.pinterest.com and nowhere else. There is no analytics vendor, no logging service, no telemetry, and no third-party API in the request path.
All traffic is HTTPS. Credentials live in a gitignored file on a single machine rather than in a shared or cloud store, which is appropriate given the app serves exactly one operator and has no multi-user surface to protect.
Platform safety
Contact
For anything relating to this app, its API usage, or these policies, write to lauren.ginart@gmail.com. Messages about the Pinterest app review are answered directly by the developer, who is the sole operator of the integration.