moodboard-mcp
Reads public Pinterest boards and profiles (including pins with images) without login, and optionally authenticates with Pinterest OAuth to access private boards, list boards, retrieve pins, and search saved pins. Also extracts design tokens such as palettes, color roles, WCAG contrast, CSS variables, and Tailwind colors from board imagery.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@moodboard-mcp Build a landing page in the style of pinterest.com/jane/saas-dashboards"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
moodboard-mcp
Turn your Pinterest boards into design references for AI coding assistants.
moodboard-mcp is an open-source Model Context Protocol server. Paste any public Pinterest board link (no account, no keys, no setup) and Claude, Cursor, VS Code or any MCP client can see the images and extract design tokens (palette, color roles, contrast, CSS variables, Tailwind colors) to build UI in that style. Optionally log in with the official Pinterest OAuth flow to use your private boards too.
You: Design a settings page in the style of https://www.pinterest.com/jane/saas-dashboards/
Claude: → get_public_board (sees 8 images) → extract_design_tokens
→ writes a style guide → builds the page with that palette.
Features
Tool | What it does |
| No login. Reads any public board or profile from its link (latest ~25 pins), with images. |
| Official Pinterest OAuth login in your browser. Token is stored locally and refreshed automatically. |
| Shows which Pinterest account is connected. |
| Deletes the local token. |
| Lists your boards. |
| Gets pins from a board, with the images attached so the model can actually see them. |
| One pin with its image. |
| Searches pins you have saved. |
| Palette + roles (background, surface, text, muted, accent), WCAG contrast, CSS vars, Tailwind. |
Prompt: moodboard_to_ui: "study board X and build Y in the same style".
Privacy by design: runs locally on your machine, no scraping, no cookies, no analytics. Public boards are read from the RSS feeds Pinterest publishes for them. Login uses read-only scopes (boards:read, pins:read, user_accounts:read) and your token is stored only on your computer.
Related MCP server: pinterest-mcp
Quick start
1. Install
Claude Desktop (one click): download moodboard-mcp.mcpb from the latest release and double-click it (or drag it into Settings → Extensions). Leave the "Advanced" fields empty. No Node.js or config editing needed.
Claude Code
claude mcp add moodboard -- npx -y moodboard-mcpCursor / other clients: add to your MCP config (e.g. ~/.cursor/mcp.json):
{
"mcpServers": {
"moodboard": { "command": "npx", "args": ["-y", "moodboard-mcp"] }
}
}2. Use it (no login)
Copy a board link from Pinterest (browser address bar, or Share → Copy link) and ask:
"Here's my moodboard: https://www.pinterest.com/username/board-name/. Design a landing page in this style."
"Extract the color palette from this board as a Tailwind config: "
Use the
moodboard_to_uiprompt with a board link and what you want built.
Works for any public board or profile, on any Pinterest domain, including pin.it short links.
3. Optional: log in for private boards
Logging in adds list_boards, get_board_pins, get_pin, search_my_pins and access to your secret boards.
One-click login: when a release includes the hosted login service, just ask "Log in to Pinterest", approve in the browser tab that opens, and you're done. Nothing to configure.
Use your own Pinterest app (advanced): needed if the release has no hosted login, or if you prefer not to use it.
You need a Pinterest business account (free; you can convert a personal one in settings).
Go to https://developers.pinterest.com/apps/ → Connect app, request Trial access, and add the redirect URI
http://localhost:8085/callback.Put the App ID and App secret in the extension's Advanced fields, or set
PINTEREST_CLIENT_ID/PINTEREST_CLIENT_SECRETin your MCP config.
Trial access approval can take a few days. Until it is approved, the API returns
401 ... consumer type is not supported.
How login works (for the curious)
Pinterest's token endpoint always requires an app secret, and a secret can't be shipped inside open-source code. So the project runs a tiny auth broker that holds the secret and forwards the token request. Your token comes straight back to your computer; the broker never stores or logs it. You can always skip it by using your own app.
Configuration
Variable | Default | Description |
| (none) | Your Pinterest App ID. |
| (none) | Your Pinterest App secret. |
| (none) | Optional static token (skips OAuth), handy for quick testing. |
| built-in | Hosted login service. Set to |
|
| Local port for the OAuth callback. Must match your app. |
|
| Use |
|
| Where the token file is stored. |
Limitations (honest)
Searching all of Pinterest is not available through the public API. Pinterest's site-wide search endpoint requires partner approval, so
search_my_pinssearches only your saved pins. Workflow tip: save inspiration to a board, then point the assistant at that board.Video pins return their cover image for now. Frame extraction is on the roadmap.
Trial apps have daily rate limits. Plenty for inspiration, but not for bulk export.
Develop from source
git clone https://github.com/ramgopal99/moodboard-mcp.git
cd moodboard-mcp
npm install
npm run build
npm testPoint your MCP client at node /absolute/path/to/moodboard-mcp/dist/index.js. You can also use the MCP Inspector:
npx @modelcontextprotocol/inspector node dist/index.jsRoadmap
Video pin frame extraction (motion/style references)
Typography hints (detect serif/sans, weight) from images
Export a full design-system JSON (spacing, radius, shadows)
Optional Streamable HTTP transport for remote hosting
Publish to the official MCP Registry
Want to help? See CONTRIBUTING.md. Issues labelled good first issue are a great start.
Contributing
Contributions of all sizes are welcome: bug reports, docs, tests, features. Please read CONTRIBUTING.md and our Code of Conduct.
Security
Please report vulnerabilities privately. See SECURITY.md.
License
MIT © Ramgopal Bagh
Not affiliated with or endorsed by Pinterest. Pinterest is a trademark of Pinterest, Inc.
Available Tools
9 toolsextract_design_tokensExtract design tokensARead-only
Analyzes the images on a board (public board link, logged-in board id, or a list of pins) and returns a color palette with roles (background, surface, text, muted, accent), WCAG contrast ratios, CSS variables and a Tailwind colors snippet.
Inputs: colors, pin_ids, board_id, max_pins, +1 more.
get_board_pinsGet pins from a boardARead-only
Gets pins from a board. With include_images=true, the actual images are returned so the model can see the designs (use this for UI/visual inspiration).
Inputs: board_id (required), limit, max_images, include_images.
get_pinGet a pinBRead-only
Gets one pin's details and (optionally) its image.
Inputs: pin_id (required), include_image.
get_public_boardGet a public board (no login)ARead-only
Reads any PUBLIC Pinterest board or profile from its link, with no login or keys. Returns the latest ~25 pins, with images attached so the model can see them. Accepts board URLs on any Pinterest domain, pin.it short links, or 'username/board-name'. Prefer this tool when the user shares a board link.
Inputs: board_url (required), limit, max_images, include_images.
list_boardsList Pinterest boardsBRead-only
Lists the logged-in user's Pinterest boards (id, name, pin count).
Inputs: limit.
pinterest_auth_statusCheck Pinterest loginARead-only
Shows whether the user is logged in to Pinterest and which account is connected.
Inputs: no named parameters.
pinterest_loginLog in to PinterestA
Starts the official Pinterest OAuth login (needed only for the user's own private/secret boards and search; public boards work without it via get_public_board). Opens the Pinterest consent page in the browser and waits briefly for approval. If approval takes longer, returns the URL; call pinterest_auth_status afterwards.
Inputs: no named parameters.
pinterest_logoutLog out of PinterestBDestructive
Deletes the locally stored Pinterest token.
Inputs: no named parameters.
search_my_pinsSearch my saved pinsBRead-only
Searches the pins the logged-in user has saved (not all of Pinterest — the public search API needs special partner access).
Inputs: query (required), limit, max_images, include_images.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool has a recognizable focus, but get_board_pins and get_public_board both return board pins with images and could be confused until the agent reads that one requires login and the other takes a public URL. The three auth tools (login/status/logout) are cleanly separated and extract_design_tokens is unmistakable.
Most tools follow a clear verb_noun snake_case pattern (list_boards, get_pin, search_my_pins, get_public_board, extract_design_tokens). The auth trio deviates with a pinterest_ prefix and noun-verb order, but it is internally consistent and still readable.
Nine tools is well within the ideal range and every tool maps to a distinct step in the read/extract workflow. Nothing feels redundant or padded.
The read path is solid (list boards, fetch pins, public boards, search, token extraction), but a moodboard server lacks any write operations — no create_board, save_pin/save_to_board, or pin creation — so agents cannot actually curate a moodboard. This is a notable gap rather than a fatal one since the stated purpose leans toward inspiration gathering.
Maintenance
Related MCP Connectors
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.
Pinterest pins, boards, profiles and keyword search to JSON: saves, images, links, creators.
Read and build visual moodboards, shot lists and lookbooks from an AI assistant.
Pinterest automation: schedule pins, manage boards, write AI blogs and auto-pin them.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with the Pinterest API, allowing management of boards and pins through natural language commands.41MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to manage Pinterest boards and pins, create and update pins, and track analytics via the Pinterest API v5.8MIT
- AlicenseAqualityCmaintenanceEnables 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.11MIT
- AlicenseAqualityBmaintenanceEnables AI assistants to browse boards, search pins, scrape images from URLs, and create, update, or pin visual bookmarks directly into a self-hosted instance.8MIT