> ## Documentation Index
> Fetch the complete documentation index at: https://docs.monk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Agents

> Set up Monk in one coding agent by hand: Claude Code, Codex, Cursor and every other supported agent

The [installer](/getting-started/installer) sets up all of these for you:

<Tabs>
  <Tab title="macOS and Linux">
    ```bash theme={"dark"}
    curl -fsSL https://get.monk.io/stable/plugin | sh
    ```
  </Tab>

  <Tab title="Windows">
    In PowerShell:

    ```powershell theme={"dark"}
    irm https://get.monk.io/stable/plugin.ps1 | iex
    ```
  </Tab>
</Tabs>

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:

```text theme={"dark"}
/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:

```bash theme={"dark"}
codex plugin marketplace add monk-io/monk-plugin
codex plugin add monk@monk-plugins
```

Restart Codex.

**Sign in:**

```bash theme={"dark"}
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](https://cursor.com/marketplace/monk-io).

Or install it straight from the plugin repository, in Cursor chat:

```text theme={"dark"}
/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

```bash theme={"dark"}
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

```bash theme={"dark"}
devin plugins install -y --local monk-io/monk-plugin
```

Restart Devin.

**Sign in:**

```bash theme={"dark"}
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](/getting-started/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.

<Tip>
  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`](https://github.com/monk-io/monk-plugin/tree/main/skills/monk) folder there (for Cline: `~/.cline/skills/monk`).
</Tip>

### 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):

```json theme={"dark"}
{
  "servers": {
    "monk": { "type": "http", "url": "http://127.0.0.1:7419/mcp" }
  }
}
```

Reload the window.

### GitHub Copilot CLI

`~/.copilot/mcp-config.json`:

```json theme={"dark"}
{
  "mcpServers": {
    "monk": { "type": "http", "url": "http://127.0.0.1:7419/mcp", "tools": ["*"] }
  }
}
```

### Gemini CLI

`~/.gemini/settings.json`:

```json theme={"dark"}
{
  "mcpServers": {
    "monk": { "type": "http", "url": "http://127.0.0.1:7419/mcp" }
  }
}
```

### Amp

`~/.config/amp/settings.json`:

```json theme={"dark"}
{
  "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:

```json theme={"dark"}
{
  "mcpServers": {
    "monk": { "url": "http://127.0.0.1:7419/mcp", "type": "streamableHttp", "disabled": false }
  }
}
```

Reload the VS Code window.

### Goose

`~/.config/goose/config.yaml`:

```yaml theme={"dark"}
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:

```json theme={"dark"}
{
  "mcpServers": {
    "monk": { "url": "http://127.0.0.1:7419/mcp" }
  }
}
```

Restart Junie or your IDE.

### Kilo Code

`~/.config/kilo/kilo.json`:

```json theme={"dark"}
{
  "mcp": {
    "monk": { "type": "remote", "url": "http://127.0.0.1:7419/mcp", "enabled": true }
  }
}
```

### OpenCode

`~/.config/opencode/opencode.json`:

```json theme={"dark"}
{
  "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:

```json theme={"dark"}
{
  "mcpServers": {
    "monk": { "type": "streamable-http", "url": "http://127.0.0.1:7419/mcp" }
  }
}
```

Reload the VS Code window.

### Warp

`~/.warp/.mcp.json`:

```json theme={"dark"}
{
  "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):

```json theme={"dark"}
{
  "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](/getting-started/installer) first, then open **Settings → Developer → Edit Config** and add:

```json theme={"dark"}
{
  "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:

```bash theme={"dark"}
~/.monk/bin/monk-agent mcp-stdio login
```

<Card title="Troubleshooting" icon="wrench" href="/getting-started/troubleshooting-installation">
  When an agent doesn't see Monk
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.