home / mcp / pinterest mcp server

Pinterest MCP Server

Provides Pinterest image search, detail retrieval, and download actions via MCP for integrated workflows.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "terryso-mcp-pinterest": {
      "command": "node",
      "args": [
        "/path/to/mcp-pinterest/dist/pinteresting-mcp-server.js"
      ],
      "env": {
        "MCP_PINTEREST_DOWNLOAD_DIR": "/path/to/downloads",
        "MCP_PINTEREST_PROXY_SERVER": "http://127.0.0.1:7890",
        "MCP_PINTEREST_FILENAME_TEMPLATE": "pinterest_{imageId}_{timestamp}.{fileExtension}"
      }
    }
  }
}

You run a Pinterest MCP Server to search Pinterest, fetch image details, and download images through MCP-enabled clients. It wires Pinterest data sources into your MCP workflow and supports headless browsing, result limiting, and flexible download naming and directory settings.

How to use

You connect an MCP client (such as Cursor) to the Pinterest MCP Server and use its functions to search for images, retrieve image information, or perform a combined search-and-download. The server runs locally and can be invoked via node directly or through npm/npx so you can integrate it into your workflows. Use the MCP functions by naming them in your client calls and providing the required parameters like search keywords and limits. If you enable headless browsing, the server will load Pinterest in the background to perform searches and fetch image data without opening a visible browser.

To integrate with Cursor, configure an MCP server entry that points to the local server executable and, if needed, set environment variables for download directory, filename template, and an optional proxy. You can also run the server via npx for quick experimentation. Once configured, you can invoke the available MCP functions from the Cursor AI chat to search for Pinterest images, obtain detailed image information, or perform a combined search-and-download, with results returned to your workspace.

How to install

Prerequisites you need before installing: Node.js version 18 or higher and Cursor IDE for MCP integration.

Option A: Use NPX (recommended) to run the server directly without a local install.

# Run the server via NPX
npx pinterest-mcp-server

# Specify a download directory
npx pinterest-mcp-server --downloadDir /path/to/downloads

# Specify a filename template
npx pinterest-mcp-server --filenameTemplate "pinterest_{id}"

# Use both options together
npx pinterest-mcp-server --downloadDir ./images --filenameTemplate "pinterest_{id}"

Option B: Global installation to run the server directly from the command line.

npm install -g pinterest-mcp-server

# Run the server with the same options as NPX
pinterest-mcp-server
pinterest-mcp-server --downloadDir /path/to/downloads --filenameTemplate "pinterest_{id}"

Option C: Install via Smithery for automatic tooling in specific environments.

npx -y @smithery/cli install mcp-pinterest --client claude

Option D: Manual installation steps if you prefer to build from source.

git clone https://github.com/terryso/mcp-pinterest.git pinterest-mcp-server
cd pinterest-mcp-server
npm install
npm run build
npm start

Additional setup and configuration

You can configure how the server downloads and names files, or route traffic through a proxy. The following environment variables and command-line options control behavior.

# Environment variables (examples)
MCP_PINTEREST_DOWNLOAD_DIR=/Users/you/PinterestDownloads
MCP_PINTEREST_FILENAME_TEMPLATE="pin_{imageId}_{timestamp}.{fileExtension}"
MCP_PINTEREST_PROXY_SERVER="http://127.0.0.1:7890"

Troubleshooting and notes

If the server fails to start, verify that the target port is not in use, dependencies are installed, and TypeScript typings are available if you build from source. Ensure the download directory exists and is writable, or the server may exit. Filenames are sanitized automatically to replace illegal characters with underscores.

Available tools

pinterest_search

Search Pinterest images by keyword with options for limit and headless mode.

pinterest_get_image_info

Fetch detailed information for a specific Pinterest image URL.

pinterest_search_and_download

Search Pinterest images by keyword and download the results to the configured directory.