Skip to main content
Claude Code runs in a separate terminal, so you keep Monk open in your IDE and launch Claude Code in the same project directory. Monk writes the config Claude Code needs automatically.
Coming soon: Headless mode — plug Monk directly into Claude Code without running a separate IDE window. Upvote it on our roadmap.

​
Setup

1

Enable Monk MCP

Open your project in VS Code, Cursor, Windsurf, or Antigravity with Monk installed. Run the command palette and choose Monk: Manage MCP Server → Enable MCP server. Pick Smart defaults or include Claude Code in the target list.Monk writes a project-scoped entry in ~/.claude.json.
2

Open Claude Code in the same directory

Launch Claude Code from the terminal in the same project root. It picks up the Monk entry automatically.Claude Code MCP Enablement
3

Verify Monk is listed

Run /mcp inside Claude Code. Monk should appear in the server list for the current project.
4

Start using Monk

Ask Claude Code to use Monk for deployment, infrastructure, or runtime tasks.Claude Code communicating with Monk

Deploy your first app

Monk is connected — now deploy your project

​
Troubleshooting

If Monk does not appear in /mcp, confirm that the IDE with Monk is still running with the same project open and that MCP is enabled for this workspace. Restarting Claude Code in the project directory usually resolves config detection issues.

More troubleshooting

Common issues and how to fix them