# ProdPad MCP Server

An MCP (Model Context Protocol) server that connects Claude to [ProdPad](https://www.prodpad.com/), giving Claude direct access to your product management data — ideas, feedback, roadmaps, OKRs, initiatives, and more.

Built with TypeScript, the [MCP SDK](https://github.com/modelcontextprotocol/typescript-sdk), and designed for use with [Claude Desktop](https://claude.ai/download).

## What Can It Do?

Once connected, you can ask Claude things like:

- "What products do I have in ProdPad?"
- "Show me our current objectives and key results"
- "List all ideas tagged with 'mobile'"
- "What's on the Now/Next/Later roadmap?"
- "Search ProdPad for anything related to onboarding"
- "Create a new idea for a dashboard redesign"
- "Create an initiative on our product roadmap"

### Available Tools (24 total)

| Category | Tools |
|----------|-------|
| **Products** | List products, get product details |
| **Objectives & Key Results** | List objectives, get objective, list key results, get key result, get KRs by objective, get KRs by product |
| **Roadmaps** | List roadmaps, get roadmap (with columns and cards), get roadmaps by product |
| **Ideas** | List ideas (with filters), get idea details |
| **Initiatives** | List initiatives, get initiative, get ideas for initiative |
| **Feedback** | List feedback (with filters), get feedback, get ideas linked to feedback |
| **Create** | Create new ideas, create new initiatives |
| **Utility** | Cross-entity search, list statuses, list tags |

## Setup Guide

### Step 1: Get Your ProdPad API Key

1. Log in to [ProdPad](https://app.prodpad.com)
2. Click the **Settings gear icon** (bottom-left sidebar)
3. Click **Profile settings**
4. Click the **API Keys** tab
5. **Copy your API key** using the copy button next to it

![How to find your ProdPad API Key](docs/prodpad-api-key.png)

> If you need to regenerate your key, click "Regenerate". This will invalidate the previous key.

For more details, see [ProdPad's API key docs](https://help.prodpad.com/article/763-generating-an-api-key).

### Step 2: Install Prerequisites

You need [Node.js](https://nodejs.org/) version 18 or later installed on your machine.

To check if you have it:

```bash
node --version
```

If you don't have it, download and install from [nodejs.org](https://nodejs.org/).

### Step 3: Download and Build the Server

1. **Download this project** — click the green "Code" button on GitHub, then "Download ZIP". Unzip it somewhere you'll remember (e.g., `C:\MCP\prodpad-mcp-server\`).

   Or if you're comfortable with git:
   ```bash
   git clone https://github.com/JTreadwell1/prodpad-mcp-server.git
   ```

2. **Open a terminal** in the project folder and run:
   ```bash
   npm install
   npm run build
   ```

   You should see no errors. This creates a `dist/` folder with the compiled server.

### Step 4: Configure Claude Desktop

1. Open Claude Desktop
2. Go to **Settings** (gear icon) > **Developer** > **Edit Config**
3. This opens a JSON file. Add the `prodpad` entry inside the `"mcpServers"` section:

```json
{
  "mcpServers": {
    "prodpad": {
      "command": "node",
      "args": [
        "C:\\path\\to\\prodpad-mcp-server\\dist\\index.js"
      ],
      "env": {
        "PRODPAD_API_KEY": "your-api-key-here"
      }
    }
  }
}
```

> **Important:** Replace `C:\\path\\to\\prodpad-mcp-server` with the actual path where you put the project. Use double backslashes (`\\`) on Windows.
>
> Replace `your-api-key-here` with the API key you copied in Step 1.

4. **Save the file** and **restart Claude Desktop**

### Step 5: Verify It Works

Start a new conversation in Claude Desktop and ask:

> "What products do I have in ProdPad?"

If Claude returns your product list, you're all set!

## Troubleshooting

**"PRODPAD_API_KEY environment variable is required"**
Your API key isn't configured. Double-check the `env` section in your Claude Desktop config.

**"Authentication failed"**
Your API key is invalid or expired. Generate a new one from ProdPad Profile Settings > API Key.

**"Resource not found"**
The ID you're looking for doesn't exist. Try listing resources first (e.g., `prodpad_list_ideas`) to find valid IDs.

**Claude doesn't show ProdPad tools**
Make sure you restarted Claude Desktop after editing the config. Check the config file is valid JSON (no trailing commas, matching brackets).

## Using with Claude Code (CLI)

If you use Claude Code (the CLI tool), add the same config to your `~/.claude.json` file under `mcpServers`.

## License

MIT