Skip to main content
Compatibility

Cursor

Set up Mouse with Cursor: installation, MCP configuration, and verification

Prerequisites

  • Cursor (latest version recommended)
  • Node.js 20.x or later

Installing Mouse

  1. Open the Extensions panel in Cursor (Ctrl+Shift+X / Cmd+Shift+X)
  2. Search for Mouse by HIC AI, Inc.
  3. Click Install
  4. Open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P) and run Mouse: Initialize Workspace

This creates a .hic directory in your project and generates the MCP configuration file at .cursor/mcp.json.

Configuration

The workspace initialization creates the following configuration automatically. If you need to configure it manually, create .cursor/mcp.json with:

{
  "mcpServers": {
    "hic_local": {
      "command": "node",
      "args": ["${workspaceFolder}/.hic/mcp/src/core/server.js"],
      "env": {
        "HIC_AGENT_ADAPTER": "cursor",
        "HIC_ALLOWED_DIRECTORIES": "${workspaceFolder}"
      }
    }
  }
}

Verifying the Connection

Ask your AI assistant:

"Use Mouse's get_file_metadata tool to check the metadata of any file in this workspace."

If the assistant successfully calls the tool and returns file metadata, Mouse is working correctly. Check the status bar; it should show Mouse: Trial or Mouse: Licensed.