Claude Code

Overview

Connect Claude Code to Shortcut through the hosted Shortcut MCP Server. Claude Code can then find, create, and update Shortcut work from the terminal using your authorized Workspace access.

Installation

1. Install and sign in to Claude Code.
2. Add Shortcut as a remote HTTP MCP server:

claude mcp add --transport http shortcut https://mcp.shortcut.com/mcp

3. Start Claude Code and follow the browser prompt to authorize Shortcut.
4. Run claude mcp list to confirm that the shortcut server is connected.

Authentication is handled with OAuth. You do not need to create or store a Shortcut API token.

Use Shortcut from Claude Code

Ask Claude Code to work with Shortcut in natural language, for example:

• “Show me Story 12345 and summarize the acceptance criteria.”
• “Find my started Stories in the current Iteration.”
• “Add a comment to Story 12345 with this implementation update.”

Claude Code will show tool calls before making changes that require approval.

For available entities and troubleshooting, see MCP Server.