Skip to main content
Glama
Sign In
deenesjakoruzh
pinterest-mcp

pinterest-mcp

by Nuu-maan
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

pinterest-mcp

Ein MCP-Server, mit dem Claude (oder ein beliebiger MCP-Client) Pinterest durchsuchen und Bilder direkt auf deinen Rechner herunterladen kann – ohne manuelles Browsen, ohne manuelles Speichern.

Er spricht mit Pinterests eigener interner Web-API (denselben Anfragen, die dein Browser macht, wenn du angemeldet bist), authentifiziert mit deinem persönlichen Session-Cookie. Es gibt keine offizielle öffentliche Pinterest-API dafür, daher hat dieses Projekt die interne rekonstruiert.

Features

  • Suche und Download – gib ein Stichwort ein, erhalte N Bilder in voller Auflösung, die lokal gespeichert werden.

  • Board-Download – gib einen Board-Link ein (Kurzlinks wie pin.it funktionieren), erhalte N Bilder davon.

  • Boards auflisten – sieh dir die Boards eines Benutzers mit Pin-Anzahl an, ohne einen direkten Link zu benötigen.

  • Board-Informationen – Name und Pin-Anzahl eines Boards nachschlagen.

  • Deduplizierung bei erneutem Lauf – beim erneuten Abrufen derselben Abfrage oder desselben Boards werden bereits heruntergeladene Bilder übersprungen, anstatt sie erneut zu laden oder veraltete Dateien zurückzulassen.

  • Metadaten-Begleitdateien – Titel, Beschreibung und Quelllink jedes Bildes werden in einer passenden .json-Datei in einem versteckten .meta-Ordner gespeichert, sodass der Bildordner selbst sauber bleibt.

Related MCP server: pinterest-mcp

Requirements

  • Python 3.14+

  • uv

  • Ein Pinterest-Konto, das im Browser angemeldet ist

Install

git clone https://github.com/Nuu-maan/pinterest-mcp.git
cd pinterest-mcp
uv sync

Getting your Pinterest cookie

Dies läuft als du und verwendet deine eigene angemeldete Sitzung – es erstellt oder benötigt keinen separaten API-Schlüssel.

  1. Öffne pinterest.com in deinem Browser und stelle sicher, dass du angemeldet bist.

  2. Öffne DevTools (F12) → Tab Netzwerk.

  3. Lade die Seite neu und klicke auf eine beliebige Anfrage an pinterest.com.

  4. Suche in den Anfrage-Headern nach Cookie: und kopiere den gesamten Wert.

Halte diesen Wert geheim – er entspricht deiner Anmeldesitzung.

Configure

Registriere den Server bei Claude Code:

claude mcp add pinterest --scope user \
  -e PINTEREST_COOKIE="<paste your cookie here>" \
  -e PINTEREST_DOMAIN="www.pinterest.com" \
  -- uv --directory /path/to/pinterest-mcp run server.py

PINTEREST_DOMAIN ist standardmäßig auf www.pinterest.com gesetzt. Wenn Pinterest dich nach der Anmeldung auf eine länderspezifische Domain umleitet (z. B. in.pinterest.com), verwende stattdessen diese.

Bilder werden standardmäßig unter ~/Pictures/pinterest-downloads/<name>/ gespeichert, oder in einem benutzerdefinierten out_dir, das du an ein Tool übergibst.

Usage

Nach der Konfiguration kannst du einfach fragen:

  • „Suche auf Pinterest nach minimalistischen Logo-Designs, lade 10 herunter"

  • „Liste meine Pinterest-Boards auf"

  • „Hole 5 Pins von diesem Board: https://pin.it/xxxxxxx"

Tools

Tool

Beschreibung

search_pinterest_images(query, count=20, out_dir=...)

Bilder suchen und herunterladen

get_pinterest_boards(username)

Die Boards eines Benutzers auflisten

get_pinterest_board_info(board_url)

Name und Pin-Anzahl eines Boards nachschlagen

fetch_pinterest_board(board_url, count, out_dir=...)

Bilder von einem Board herunterladen

Development

uv run -- python -m tests.test_pins
uv run -- python -m tests.test_downloader

Disclaimer

Dies verwendet Pinterests interne, inoffizielle API, keine öffentliche Entwickler-API. Sie kann brechen, wenn Pinterest seine Endpunkte ändert, und intensive Nutzung könnte die Aufmerksamkeit ihrer Bot-Erkennung erregen. Verwende sie mit deinem eigenen Konto, auf eigenes Risiko.

License

MIT – siehe LICENSE.

Contributing

Siehe CONTRIBUTING.md.

Available Tools

4 tools
fetch_pinterest_boardB

Download up to count full-resolution images from a Pinterest board (accepts pin.it short links).

NameRequiredDescriptionDefault
countYes
out_dirNo/root/Pictures/pinterest-downloads
board_urlYes
get_pinterest_board_infoA

Look up a Pinterest board's name and total pin count from its URL (accepts pin.it short links).

NameRequiredDescriptionDefault
board_urlYes
get_pinterest_boardsA

List a Pinterest user's boards with url and pin count.

NameRequiredDescriptionDefault
usernameYes
search_pinterest_imagesB

Search Pinterest for query and download up to count full-resolution images.

NameRequiredDescriptionDefault
countNo
queryYes
out_dirNo/root/Pictures/pinterest-downloads

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 4 tool updatesv0.1.0
    • First observedfetch_pinterest_board
    • First observedget_pinterest_board_info
    • First observedget_pinterest_boards
    • First observedsearch_pinterest_images
Deploy Server
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

TDQS

A3.5/5.0

Scored across 4 tools

Disambiguation4/5

Each tool has a clear purpose: search images, list boards, get board info, and fetch board images. The slight overlap between search_pinterest_images and fetch_pinterest_board (both download images) is mitigated by their distinct sources (query vs. board). No two tools are truly confusing.

Naming Consistency4/5

All names follow a verb_noun pattern (search, get, fetch). However, there is a mix of 'get' and 'fetch' for similar actions, and 'get_pinterest_boards' vs 'get_pinterest_board_info' could be slightly more distinctive. Still, the pattern is consistent enough for an agent to predict behavior.

Tool Count4/5

Four tools is a reasonable scope for a Pinterest-focused server. It covers the core actions of searching and retrieving board content without being overly sparse or bloated. The count fits well within the typical 3-15 range.

Completeness3/5

The server covers browsing and downloading images from searches and boards, but lacks operations for pin-level details, user profiles, or any create/update/delete actions. For a read-only image-centric tool, it's decent, but there are noticeable gaps for a full Pinterest API surface.

Maintenance

ActivityStale
ResponsivenessNo recent community issues

Resources

Related MCP Connectors

Related MCP Servers

  • pinterest-mcp

    clugtu
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI agents to manage Pinterest boards and pins, create and update pins, and track analytics via the Pinterest API v5.
    8
    MIT

  • pinterest-mcp

    Martin-Code202
    A
    license
    A
    quality
    D
    maintenance
    Extracts images, gifs, videos, and search results from Pinterest without authentication. Supports search, pin details, board pins, related pins, autocomplete, and media downloads.
    6
    28 npm
    1
    MIT

  • Pinterest MCP Server

    Kargatharaakash
    A
    license
    B
    quality
    D
    maintenance
    Enables image search and information retrieval from Pinterest using the Model Context Protocol. Supports searching by keywords, getting similar pins, and downloading images directly.
    5
    150 npm
    MIT

  • 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.
    -