Connecting Claude Desktop to ShapeUp

Use Claude Desktop's Model Context Protocol (MCP) to manage your Shape Up work directly through conversation with Claude. Create tasks, generate cookbooks, and manage your cycles - all without leaving Claude Desktop.

Note: This is a Pro feature. Go Pro

1. What is MCP?

MCP (Model Context Protocol) is an open standard that lets AI assistants like Claude Desktop connect to external tools and services. Once configured, Claude can read and write to your ShapeUp account, making it your AI-powered project management assistant.

2. Connect Your MCP Client

ShapeUp works with any MCP-compatible client. Here are some popular options:

Claude Desktop

1. Open Settings in Claude Desktop
2. Go to the MCP section
3. Add a new server with URL:
```
https://shapeup.cc/mcp
```

Claude Code (CLI)

1. Run in your terminal:

claude mcp add \
  --transport http \
  shapeup \
  https://shapeup.cc/mcp

2. Start using ShapeUp tools!

🔌 Other MCP Clients

Any application that supports the Model Context Protocol can connect to ShapeUp. Just use the URL https://shapeup.cc/mcp with HTTP transport in your client's MCP configuration.

3. Authorize Your MCP Client

When your MCP client first tries to access ShapeUp, you'll need to authorize the connection:

1. When you first try to use ShapeUp tools, you'll be prompted to authorize the connection.
2. Your MCP client will open your browser to the ShapeUp authorization page.
3. Review the permissions and click "Authorize" to grant access to your ShapeUp organisations.
4. You'll be redirected back to your MCP client automatically.

🔒 Security

ShapeUp uses OAuth 2.1 with PKCE for secure authentication.

4. Available Tools

Once connected, your MCP client can help you manage your Shape Up work:

📋 Browse & Query

• List cycles, pitches, scopes, and tasks
• View pitch and issue details with recent comments inline
• Search across everything

🐛 Issues

• Create, triage, and assign issues
• Mark done, close, or icebox
• Filter by stream, tag, or assignee
• Convert an issue to a pitch, or fold it into an existing one

✏️ Create & Update

• Create scopes, tasks, and issues
• Mark tasks as complete
• Add comments and reactions
• Add and tick checklist items on pitches and issues
• Tag pitches and issues, and filter the list by tag

🤖 AI-Powered

• Generate scope suggestions
• Create cycle cookbooks
• Use your Shape AI credits

5. Example Prompts

Try these example prompts with your MCP client:

"What organisations do I have access to?"
"Show me active cycles for Compass Labs"
"List all packages in cycle 14"
"Create a task in package 237: Implement login validation"
"Generate a cookbook for cycle 14"
"Convert issue 146 into a pitch"
"Add a checklist item to pitch 42: confirm Slack webhook secret rotation"
"Tag pitch 42 as Q3-plan and show me everything tagged Q3-plan"