@striderlabs/mcp-pinterest
# @striderlabs/mcp-pinterest
MCP server connector for Pinterest — search pins, manage boards, save pins, and follow users via Playwright browser automation.
## Installation
```bash
npm install @striderlabs/mcp-pinterest
```
## Configuration
Set environment variables:
```bash
export PINTEREST_EMAIL="your-email@example.com"
export PINTEREST_PASSWORD="your-password"
export PINTEREST_HEADLESS="true" # Set to "false" to see browser
```
## Tools
| Tool | Description |
|------|-------------|
| `search_pins` | Search for pins by query |
| `get_pin_details` | Get detailed info about a pin |
| `get_board` | Get pins from a board |
| `get_user_boards` | Get user's boards |
| `save_pin` | Save a pin to a board |
| `create_board` | Create a new board |
| `follow_user` | Follow a Pinterest user |
| `get_home_feed` | Get personalized home feed |
| `get_trending` | Get trending pins |
| `get_my_boards` | Get your boards |
## MCP Configuration
Add to your MCP config:
```json
{
"mcpServers": {
"pinterest": {
"command": "npx",
"args": ["@striderlabs/mcp-pinterest"],
"env": {
"PINTEREST_EMAIL": "your-email",
"PINTEREST_PASSWORD": "your-password"
}
}
}
}
```
## License
MIT
TDQS
Scored across 10 tools
Tools are mostly distinct, but get_user_boards and get_my_boards both retrieve boards, differing only by user scope. get_board retrieves pins from a specific board, while get_user_boards lists boards, so the boundary is clear with descriptions.
All tool names follow a consistent verb_noun pattern in lower_snake_case (search_, get_, save_, create_, follow_). No mixed conventions or vague verbs like 'process' or 'run'.
10 tools is well within the ideal 3-15 range for a domain-specific server. Each tool covers a distinct Pinterest action, and there is no redundancy or bloat.
The surface covers core Pinterest workflows: searching, viewing pins/boards, saving pins, creating boards, following users, and feed/trending. Missing update/delete operations for pins and boards, but these are less critical and can be worked around.