Install Kasy

Start with the MCP in Cursor or Claude. No Node? Install Node. Prefer the terminal? Use the installer.

The main path is through your AI assistant (MCP). The terminal is only for the one-time setup.

Implementation

1. Recommended path: MCP

Works on Windows, macOS, and Linux.

Do you have Node.js 18+? Run node -v.
No? The installer below installs Node for you.
Run the installer (CLI + MCP + Cursor / Claude Desktop config):

macOS and Linux
```
curl -fsSL https://kasy.dev/install | bash
```
Windows (PowerShell)
```
irm https://kasy.dev/install.ps1 | iex
```
Quit and reopen Cursor (or Claude Desktop). In Claude Desktop, quit the app fully, not just the window.
Done. Ask your assistant: "Prepare my machine for Kasy".

kasy mcp setup writes the kasy block to ~/.cursor/mcp.json (and Claude Desktop if present). Quit Cursor with Cmd+Q and reopen. In Settings → MCP, confirm kasy is green. Then start a new chat.

To do it manually (or if auto-setup fails), paste the JSON below in Cursor → Settings → MCP or in ~/.cursor/mcp.json.

Update (when a new version ships):

kasy upgrade

Then quit and reopen your client. The command updates both CLI and MCP.

Other IDEs (Antigravity, Codex, Windsurf…)

The MCP protocol is the same everywhere. The installer configures Cursor and Claude Desktop automatically. For another IDE, run kasy mcp setup and paste the JSON it prints into that tool's MCP config file.

Manual config (if your client is not Cursor or Claude Desktop):

Manual config (Cursor Settings → MCP, or ~/.cursor/mcp.json):

{
  "mcpServers": {
    "kasy": {
      "command": "/absolute/path/to/kasy-mcp"
    }
  }
}

kasy mcp setup fills the absolute path for you. Run npm install -g kasy-mcp first (the installer does this).

Tools, resources, and the full flow: Kasy MCP.

2. Alternative path: terminal (global CLI)

To type kasy in a terminal instead of talking to the assistant:

Use the installer above (MCP step 2) or npm install -g kasy-cli
Confirm: kasy --version
Next: prepare your machine

You can use both: MCP in Cursor and kasy in the terminal.

Information

What the MCP brings

	MCP (`kasy mcp setup`)	CLI in the terminal
Assistant uses the kit	Yes	Yes (you type)
`kasy` command in terminal	Optional	Yes
Update	`kasy upgrade` + reopen client	`kasy upgrade`

npm (CLI only, no installer)

npm install -g kasy-cli

The correct package is kasy-cli, not kasy.

What the installer does

If Node is missing, it installs it (macOS via Homebrew, Windows via winget), then installs the global CLI.

Last updated on 08/02/2026