Agents

The installer sets up all of these for you:

macOS and Linux
Windows

curl -fsSL https://get.monk.io/stable/plugin | sh

In PowerShell:

irm https://get.monk.io/stable/plugin.ps1 | iex

Use this page when you want to add Monk to one agent yourself, or to check what the installer did. Each agent has the same three steps: install, reload, sign in.

Claude Code

Run these inside Claude Code:

/plugin marketplace add monk-io/monk-plugin
/plugin install monk@monk-plugins
/reload-plugins

If /reload-plugins isn’t available, restart Claude Code. Sign in: run /mcp, choose monk, and authenticate in the browser. Update: /plugin update monk@monk-plugins, then /reload-plugins. Remove: /plugin uninstall monk@monk-plugins.

Codex

Run these in a terminal:

codex plugin marketplace add monk-io/monk-plugin
codex plugin add monk@monk-plugins

Restart Codex. Sign in:

codex mcp login monk

Update: codex plugin marketplace upgrade monk-plugins, then codex plugin add monk@monk-plugins. Remove: codex plugin remove monk@monk-plugins.

Cursor

Install Monk from the Cursor marketplace. Or install it straight from the plugin repository, in Cursor chat:

/add-plugin https://github.com/monk-io/monk-plugin

Restart Cursor, then open Settings → Tools & MCP and check that monk is listed and enabled. Sign in: use the login button next to the monk server in Settings → Tools & MCP. Remove: remove Monk from Cursor’s plugin settings.

Google Antigravity

agy plugin install https://github.com/monk-io/monk-plugin/tree/main/.antigravity-plugin

Restart Antigravity and open a project. Plugins load in a workspace, so Monk appears once a project is open. Sign in: open Agent Settings → Customizations and choose Authenticate next to monk. Update: run the install command again.

Devin

devin plugins install -y --local monk-io/monk-plugin

Restart Devin. Sign in:

devin mcp login monk

Update: devin plugins update monk.

Agents Without a Plugin

These agents connect to Monk as an MCP server. Monk has to be installed and running on your computer first: run the installer, which also writes these entries for you. Each entry points at http://127.0.0.1:7419/mcp. Add it under the key shown, keeping whatever else is in the file, then restart the agent. Sign in when the agent asks, or through its MCP settings.

The installer also adds the Monk skill, which teaches the agent how to work with Monk, to ~/.agents/skills/monk. To add it by hand, copy the skills/monk folder there (for Cline: ~/.cline/skills/monk).

VS Code (Copilot)

Run MCP: Open User Configuration from the Command Palette, or edit mcp.json in your VS Code user folder (~/Library/Application Support/Code/User on macOS, ~/.config/Code/User on Linux, %APPDATA%\Code\User on Windows):

{
  "servers": {
    "monk": { "type": "http", "url": "http://127.0.0.1:7419/mcp" }
  }
}

Reload the window.

GitHub Copilot CLI

~/.copilot/mcp-config.json:

{
  "mcpServers": {
    "monk": { "type": "http", "url": "http://127.0.0.1:7419/mcp", "tools": ["*"] }
  }
}

Gemini CLI

~/.gemini/settings.json:

{
  "mcpServers": {
    "monk": { "type": "http", "url": "http://127.0.0.1:7419/mcp" }
  }
}

Amp

~/.config/amp/settings.json:

{
  "amp.mcpServers": {
    "monk": { "url": "http://127.0.0.1:7419/mcp" }
  }
}

Cline

Cline’s MCP settings file, cline_mcp_settings.json in VS Code’s globalStorage/saoudrizwan.claude-dev/settings folder:

{
  "mcpServers": {
    "monk": { "url": "http://127.0.0.1:7419/mcp", "type": "streamableHttp", "disabled": false }
  }
}

Reload the VS Code window.

Goose

~/.config/goose/config.yaml:

extensions:
  monk:
    name: monk
    type: streamable_http
    uri: http://127.0.0.1:7419/mcp
    enabled: true
    timeout: 300

JetBrains Junie

~/.junie/mcp/mcp.json, shared by the Junie CLI and the IDE plugin:

{
  "mcpServers": {
    "monk": { "url": "http://127.0.0.1:7419/mcp" }
  }
}

Restart Junie or your IDE.

Kilo Code

~/.config/kilo/kilo.json:

{
  "mcp": {
    "monk": { "type": "remote", "url": "http://127.0.0.1:7419/mcp", "enabled": true }
  }
}

OpenCode

~/.config/opencode/opencode.json:

{
  "mcp": {
    "monk": { "type": "remote", "url": "http://127.0.0.1:7419/mcp", "enabled": true }
  }
}

Roo Code

Roo’s global MCP settings, mcp_settings.json in VS Code’s globalStorage/rooveterinaryinc.roo-cline/settings folder:

{
  "mcpServers": {
    "monk": { "type": "streamable-http", "url": "http://127.0.0.1:7419/mcp" }
  }
}

Reload the VS Code window.

Warp

~/.warp/.mcp.json:

{
  "mcpServers": {
    "monk": { "url": "http://127.0.0.1:7419/mcp" }
  }
}

Start a new agent session. Warp starts the server and asks you to sign in.

Zed

Zed’s settings.json (~/.config/zed/settings.json, or %APPDATA%\Zed\settings.json on Windows):

{
  "context_servers": {
    "monk": { "source": "custom", "type": "http", "url": "http://127.0.0.1:7419/mcp", "headers": {} }
  }
}

Any Other MCP Agent

Add a streamable HTTP MCP server named monk at http://127.0.0.1:7419/mcp. Monk signs the agent in with OAuth the first time it connects.

Claude Desktop

Claude Desktop only starts MCP servers as local commands, so it connects through Monk’s stdio bridge. Install Monk with the installer first, then open Settings → Developer → Edit Config and add:

{
  "mcpServers": {
    "monk": { "command": "/Users/you/.monk/bin/monk-agent", "args": ["mcp-stdio"] }
  }
}

Use your own home folder in the path (C:\\Users\\you\\.monk\\bin\\monk-agent.exe on Windows). Restart Claude Desktop and ask it to sign in to Monk, or run this in a terminal:

~/.monk/bin/monk-agent mcp-stdio login

Troubleshooting

When an agent doesn’t see Monk

Start here

Install

Connect a cloud

Help

Claude Code

Codex

Cursor

Google Antigravity

Devin

Agents Without a Plugin

VS Code (Copilot)

GitHub Copilot CLI

Gemini CLI

Amp

Cline

Goose

JetBrains Junie

Kilo Code

OpenCode

Roo Code

Warp

Zed

Any Other MCP Agent

Claude Desktop

Troubleshooting

​Claude Code

​Codex

​Cursor

​Google Antigravity

​Devin

​Agents Without a Plugin

​VS Code (Copilot)

​GitHub Copilot CLI

​Gemini CLI

​Amp

​Cline

​Goose

​JetBrains Junie

​Kilo Code

​OpenCode

​Roo Code

​Warp

​Zed

​Any Other MCP Agent

​Claude Desktop

Troubleshooting

Claude Code

Codex

Cursor

Google Antigravity

Devin

Agents Without a Plugin

VS Code (Copilot)

GitHub Copilot CLI

Gemini CLI

Amp

Cline

Goose

JetBrains Junie

Kilo Code

OpenCode

Roo Code

Warp

Zed

Any Other MCP Agent

Claude Desktop