Skip to content
MCP server

Cursor MCP

Cursor's agent (cursor-agent CLI) through MCP: any model your plan offers, resumable…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.2.3
Listing updated
5 days ago

About Cursor MCP

Cursor MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Cursor's agent (cursor-agent CLI) through MCP: any model your plan offers, resumable sessions.

Install

Run in a terminal

claude mcp add cursor-mcp -- npx -y @qmediat.io/cursor-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "cursor-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@qmediat.io/cursor-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "cursor-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@qmediat.io/cursor-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "cursor-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@qmediat.io/cursor-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "cursor-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@qmediat.io/cursor-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "cursor-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@qmediat.io/cursor-mcp"
      ]
    }
  }
}

Configuration

  • CURSOR_MAX_CONCURRENCYMaximum concurrent cursor-agent processes: a positive integer; anything else is the default 3.
  • CURSOR_ALLOW_YOLOSet to `true` to run cursor-agent with --force (auto-approve every tool call) in cursor_agent and cursor_reply. DANGEROUS — trusted environments only. Never exposed as a tool parameter.
  • CURSOR_SANDBOX`enabled` or `disabled`, passed to cursor-agent as --sandbox <mode>: confines what an auto-approved agent may run. Unset leaves the CLI's default; any other value ends the server at startup.
  • CURSOR_KILL_GRACE_MSAfter SIGTERM (timeout or cancellation), a child still alive this long is sent SIGKILL. A positive integer of milliseconds; default 5000.

Pricing

Open source

Cursor MCP FAQ

Is Cursor MCP free?

Yes. Cursor MCP is open source, so you can use and self-host it for free.

How do I add Cursor MCP to Claude Code?

Run this command in your terminal: claude mcp add cursor-mcp -- npx -y @qmediat.io/cursor-mcp