MCP Setup

Connect Simple Product to your AI coding assistant using the Model Context Protocol (MCP). Access boards, docs, customers, and feedback without leaving your editor.

Quick Install (CLI — all desktop tools)

One command. Detects and configures Claude Code, Claude Desktop, Cursor, Windsurf, and VS Code on this machine:

npx @simple-product/mcp --install

Opens your browser once for sign-in, then writes the right config to each tool it finds. No editing JSON yourself.

Custom Connector (Claude on web + mobile)

The CLI installer above is local-only — it can't reach Claude on mobile or the web app. To use Simple Product from claude.ai or the Claude mobile apps, add it as an account-level Custom Connector:

1. Copy the connector URL

https://simpleproduct.dev/api/mcp/v1

2. Open the Add Connector modal in Claude and paste the URL

Add in Claude →

Requires Claude Pro or Max. Once added, Simple Product appears in Claude on every surface you're signed into — Desktop, web, iOS, Android. Safe to use this alongside the CLI install above; both hit the same backend.

Supported Tools

Claude Code

Anthropic's CLI coding assistant

Claude Desktop

Claude's desktop application

Cursor

AI-powered code editor

Windsurf

Codeium's AI IDE

VS Code

With MCP extension

Manual Setup

Claude Code

Run this command to add Simple Product to Claude Code:

claude mcp add --transport stdio simple-product -- npx @simple-product/mcp@latest

For global installation (all projects), add --scope user (must come before the server name).

Claude Desktop

Add this to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{ "mcpServers": { "simple-product": { "command": "npx", "args": ["@simple-product/mcp@latest"] } } }

Cursor

Add to ~/.cursor/mcp.json:

{ "mcpServers": { "simple-product": { "command": "npx", "args": ["@simple-product/mcp@latest"] } } }

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{ "mcpServers": { "simple-product": { "command": "npx", "args": ["@simple-product/mcp@latest"] } } }

VS Code

VS Code has native MCP support. Add Simple Product to your workspace at .vscode/mcp.json:

{ "servers": { "simple-product": { "command": "npx", "args": ["@simple-product/mcp@latest"] } } }

Note the root key is servers here, not mcpServers — VS Code silently rejects configs with the wrong key.

Other MCP-compatible tools

Any tool that speaks the standard Model Context Protocol can run Simple Product. Find the tool's MCP config file (often named mcp.json, mcp_config.json, or living inside the app's settings JSON) and add this entry:

{ "mcpServers": { "simple-product": { "command": "npx", "args": ["@simple-product/mcp@latest"] } } }

Requires Node.js 18+ on the path. The first time the bridge runs, it'll open your browser to sign you in; credentials are then stored at ~/.simple-product/config.json.

Authentication

On first run, the MCP server signs you in through your browser:

A browser tab opens to sign in to Simple Product
Approve the connection on the consent screen
The tab closes and the server connects to your workspace

Credentials are stored at ~/.simple-product/config.json and persist across sessions. To re-authenticate or switch workspaces, run npx @simple-product/mcp --reauth.

Available Tools

Once connected, your AI assistant can use these tools. You can invoke them by name, or just ask in plain English — Claude will pick the right one.

Documents

create_docCreate a new doc. Content is markdown.

update_docUpdate a doc's title or content.

get_docRead a doc's full content by ID.

search_docsFind docs by title.

Cards

create_cardCreate a card on a board, optionally in a specific stage.

update_cardUpdate a card's title or description.

move_cardMove a card to a different stage.

search_cardsSearch cards by title or description across boards.

list_cardsList cards on a board, optionally filtered by stage.

get_cardRead a card's full details and links.

Boards

list_boardsList all boards in the workspace with their stages.

get_boardRead a board's stages.

create_boardCreate a new board with stages.

People & organizations

create_personCreate a CRM contact.

update_personUpdate a person's profile fields.

search_peopleSearch people by name or email.

create_orgCreate an organization (customer account).

update_orgUpdate an organization's profile fields.

search_orgsSearch organizations by name or domain.

Releases

create_releaseCreate a changelog release in markdown.

update_releaseUpdate a release's title or content.

get_releaseRead a release's content and publish state.

search_releasesSearch releases by title or content.

list_releasesList the most recent releases.

Feedback

create_feedbackCapture a piece of customer feedback.

update_feedbackUpdate a feedback entry's title or content.

get_feedbackRead a feedback entry's full content.

search_feedbackSearch feedback by title or content.

list_feedbackList the most recent feedback.

Comments

create_commentPost a comment on a card, doc, or feedback.

Email (Gmail)

draft_emailCreate a draft in your connected Gmail. Not sent.

send_emailSend an email from your connected Gmail. Irreversible.

list_emailsList recent emails, optionally filtered by query.

list_draftsList your current Gmail drafts.

Linking (relationships between items)

link_doc_to_cardAssociate a doc with a card.

unlink_doc_from_cardRemove a doc ↔ card link.

get_docs_for_cardList docs linked to a card.

get_cards_for_docList cards linked to a doc.

link_doc_to_docAssociate two docs.

unlink_doc_from_docRemove a doc ↔ doc link.

get_linked_docsList docs linked to a specific doc (either direction).

link_doc_to_personAssociate a doc with a person.

unlink_doc_from_personRemove a doc ↔ person link.

get_docs_for_personList docs linked to a person.

get_people_for_docList people linked to a doc.

link_card_to_personAssociate a card with a person — e.g. attach a customer's request to a card.

unlink_card_from_personRemove a card ↔ person link.

get_cards_for_personList cards linked to a person.

get_people_for_cardList people linked to a card.

Workspace & identity

whoamiReturn the authenticated user and active workspace.

list_workspacesList all workspaces you're a member of.

list_workspace_membersList people with login access to the workspace (your team).

switch_workspaceChange the active workspace for the session.

get_setup_guideGet code examples for integrating SP into your app (SDK, webhooks, etc.).

Search

searchUniversal search across boards, docs, people, orgs, feedback, releases.

search_chat_historySearch your past in-app AI chat conversations.

Example Usage

With the MCP connected, you can ask your AI assistant things like:

"What cards are in the backlog?"
"Create a card for implementing dark mode"
"Search for feedback about the login page"
"Show me recent customer requests"
"Create a release note for the new export feature"
"Move the authentication bug to In Progress"

Troubleshooting

MCP not showing in tool list

Restart your editor after configuration. The MCP server must be running for tools to appear.

Authentication expired

Run npx @simple-product/mcp --install again to re-authenticate.

Wrong workspace

Use the switch_workspace tool or re-authenticate to select a different workspace.