Cursor

This guide explains how to add our MCP server to Cursor.

Add the MCP Server to Cursor

Open your MCP configuration by either:

  • Going to Settings > Cursor Settings > Tools & Integrations > New MCP Server.
  • Editing the ~/.cursor/mcp.json file directly.

Paste the following configuration:

{
  "mcpServers": {
    "kaimo": {
      "command": "npx",
      "args": ["-y", "--registry=https://packages.kaimo.ai", "@kaimo-ai/mcp-server"],
      "env": {
        "API_KEY": "your-kaimo-api-key",
        "TEST_USER_USERNAME": "your_test_user@example.com",
        "TEST_USER_PASSWORD": "YourTestPassword",
        "TARGET_URL": "http://localhost:3000"
      }
    }
  }
}

You may also install in a specific project by creating a .cursor/mcp.json file in the root folder of your project.

Environment Variables:

  • API_KEY: Your platform API key. Get an API key by going to Kaimo’s web app and clicking API Keys at the top of the homepage.
  • TEST_USER_USERNAME: Email address or username for the test user account. Make sure this user already exists for your locally running web app.
  • TEST_USER_PASSWORD: Password for the test user account.
  • TARGET_URL: The URL of your locally running web app.

Running Your First Flow

You’re all set! See how to run your first flow here.