MCP (Model Context Protocol)

Last updated: June 2025

Use MCP (Model Context Protocol) to connect your AI agent to GitKraken CLI

Model Context Protocol (MCP) seamlessly connects your GitKraken CLI with your Large Language Model (LLM) application, enabling you to manage pull requests, issues, work items, and more directly through your AI desktop agent.

Pre Installation Checklist

1. Download the GitKraken CLI
2. Follow the GitKraken CLI Installation Guide
3. Authenticate to your GitKraken Account
4. Synchronize your GitKraken Integrations with the CLI

Please see our MCP blog post with example workflows that can be enabled with this powerful tool.

MCP Setup

Install Command

GitKraken CLI allows you easily install MCP on various tools with gk mcp install.

In this example we are installing GitKraken MCP to Claude using gk mcp install claude

To install MCP for your preferred tool, use the command gk mcp install <PLATFORM>. If you’ve installed your LLM application in a non-default location, include the -file-path argument: gk mcp install <PLATFORM> -file-path.

Supported LLM applications:

• Claude
• Windsurf
• Cursor
• Zed
• VSCode

To uninstall at anytime please use gk mcp uninstall <PLATFORM>

Self Installation

GitKraken CLI will connect locally with most LLMs by setting an MCP arguement. Please see the string below:

{
  "mcpServers": {
    "gitkraken": {
      "command": "gk",
      "args": ["mcp"]
    }
  }
}

Example Integrations

Claude

1. Open Settings from the sidebar or use keyboard shortcuts.
2. Select the Developer tab in the pop-up window.
3. Click Edit Config to open the claude_desktop_config JSON file.
4. Add the following MCP configuration:

{
  "mcpServers": {
    "gitkraken": {
      "command": "gk",
      "args": ["mcp"]
    }
  }
}

Windsurf

1. Locate the mcp_config.json file. The default path is ~/.codeium/windsurf/mcp_config.json.
2. Add the GitKraken CLI entry:

{
  "mcpServers": {
    "gitkraken": {
      "command": "gk",
      "args": ["mcp"]
    }
  }
}

GitHub Copilot

1. Click the Copilot icon.
2. Select Edit Preferences from the menu.
3. In the left panel, expand Copilot Chat and click MCP.
4. Add the following to the JSON configuration file:

{
  "servers": {
    "gitkraken": {
      "type": "stdio",
      "command": "gk",
      "args": ["mcp"]
    }
  }
}