Mcp Pinterest

Name: Mcp Pinterest
Author: terryso

@terryso

Repository

About Mcp Pinterest

No overview available yet

#mcp-pinterest #image-search #information-retrieval

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "pinterest": {
      "command": "npx",
      "env": {
        "MCP_PINTEREST_DOWNLOAD_DIR": "/Users/xxx/Desktop/Images",
        "MCP_PINTEREST_FILENAME_TEMPLATE": "pin_{imageId}_{timestamp}.{fileExtension}"
      },
      "args": [
        "pinterest-mcp-server"
      ]
    }
  }
}

Tools

Search for images on Pinterest by keyword

Get Pinterest image information

Search for images on Pinterest by keyword and download them

Overview

What is Mcp Pinterest?

Mcp Pinterest is a Model Context Protocol (MCP) server that provides Pinterest image search and information retrieval. It integrates with Cursor IDE via MCP, enabling AI to search, inspect, and download Pinterest images programmatically.

How to use Mcp Pinterest?

Install via Smithery (npx -y @smithery/cli install mcp-pinterest --client claude) or clone the repository, run npm install and npm run build, then configure the built JavaScript file as an MCP server in Cursor IDE (either through the interface or by editing ~/.cursor/mcp.json). Use environment variables like MCP_PINTEREST_DOWNLOAD_DIR to control download paths, filename templates, and proxy settings.

Key features of Mcp Pinterest

Pinterest image search by keyword
Retrieve detailed image information
Search and download images from Pinterest
Headless browser mode support
Configurable result limit and download directory
Proxy server support for restricted regions

Use cases of Mcp Pinterest

Searching for reference images during AI-assisted design or development
Downloading Pinterest images for datasets or content curation
Retrieving metadata about specific Pinterest pins when integrated with Cursor AI

FAQ from Mcp Pinterest

What are the runtime requirements for Mcp Pinterest?

Node.js v18 or higher is required, and Cursor IDE is needed for MCP integration.

How do I configure the download directory and filename template?

Set the environment variables MCP_PINTEREST_DOWNLOAD_DIR and MCP_PINTEREST_FILENAME_TEMPLATE. The default download directory is ../downloads relative to the server script, and the default filename template is pinterest_{imageId}.{fileExtension}.

Can I use a proxy to access Pinterest?

Yes, set the MCP_PINTEREST_PROXY_SERVER environment variable to an HTTP, HTTPS, SOCKS4, or SOCKS5 proxy URL (e.g., http://127.0.0.1:7890).

What MCP tools does the server expose?

It exposes pinterest_search, pinterest_get_image_info, and pinterest_search_and_download. Each accepts keyword, limit, and headless parameters as appropriate.