> ## 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.

# Use Monk with Cursor

> Enable Monk MCP and make it available to Cursor

Monk and the Cursor agent run in the same IDE window. The Monk MCP server is enabled automatically during [setup](/getting-started/installation) — all you need to do is let Cursor see it.

<Info>
  Cursor can also install the [Monk agent plugin](/getting-started/agent-plugin-installation) directly with `/add-plugin https://github.com/monk-io/monk-plugin`.
</Info>

## Prerequisites

Make sure you have completed the [Monk setup](/getting-started/installation) and the MCP server step shows as running in the setup screen.

## Setup

<Steps>
  <Step title="Restart Cursor">
    Fully quit and reopen Cursor so it picks up the Monk config in `.cursor/mcp.json`.
  </Step>

  <Step title="Verify Monk is visible">
    Open Cursor Settings (`Cmd+Shift+J` / `Ctrl+Shift+J`) and go to **Tools & MCP**. Monk should be listed as an MCP server.
  </Step>

  <Step title="Start using Monk">
    Cursor Agent picks up Monk tools automatically. It will ask for approval before calling them — approve and go.

    <img src="https://mintcdn.com/monk-d20f97b6/iTVBwF9nbUUE5DjB/assets/deploying_app_through_cursor_agent.gif?s=9d31711765a1908f826da3db9b729e5e" alt="Cursor agent communicating with Monk" height="200" className="rounded-lg" data-path="assets/deploying_app_through_cursor_agent.gif" />
  </Step>
</Steps>

<Card title="Deploy your first app" icon="rocket" href="/getting-started/first-deployment" color="#3B82F6">
  Monk is connected — now deploy your project
</Card>

<Card title="Install the agent plugin" icon="plug-circle-plus" href="/getting-started/agent-plugin-installation">
  Direct Cursor plugin setup and troubleshooting
</Card>

## Troubleshooting

If Monk does not appear in **Tools & MCP**, confirm the project is open at the correct root, Monk MCP is enabled for this workspace, and Cursor has been restarted after the config was generated.

<Card title="More troubleshooting" icon="wrench" href="/getting-started/troubleshooting-installation">
  Common issues and how to fix them
</Card>