diff --git a/source/_integrations/mcp_server.markdown b/source/_integrations/mcp_server.markdown index 95d031b5e83..e16d92ea6ba 100644 --- a/source/_integrations/mcp_server.markdown +++ b/source/_integrations/mcp_server.markdown @@ -117,6 +117,33 @@ to allow Claude for Desktop to access Home Assistant using the SSE transport. ![Screenshot of Claude for Desktop adding an item to a Home Assistant To-do list](/images/integrations/mcp_server/claude-todo-list-control.png) +### Example: Cursor + +1. Download and install [Cursor](https://www.cursor.com). +2. Install `mcp-proxy` following the instructions in the [README](https://github.com/sparfenyuk/mcp-proxy). + For example, `uv tool install git+https://github.com/sparfenyuk/mcp-proxy`. +3. Open the main Cursor Settings and select **MCP**. +4. Click **Add new global MCP server** and add the Home Assistant server configuration: + ```json + { + "mcpServers": { + "Home Assistant": { + "command": "mcp-proxy", + "args": [ + "http://localhost:8123/mcp_server/sse" + ], + "env": { + "API_ACCESS_TOKEN": "" + } + } + } + } + ``` +5. Save your `mcp.json` file. You can also find this file in the `$HOME/.cursor/mcp.json` directory. +6. Restart Cursor and return to the MCP settings. You should see the Home Assistant server in the list. The indicator should be green. +7. In chat agent mode (Ctrl+I), ask it to control your home and the tool should be used. + +![Screenshot of Cursor controlling the office lights](/images/integrations/mcp_server/cursor-lights-control.png) ## Supported functionality diff --git a/source/images/integrations/mcp_server/cursor-lights-control.png b/source/images/integrations/mcp_server/cursor-lights-control.png new file mode 100644 index 00000000000..d59baf772b6 Binary files /dev/null and b/source/images/integrations/mcp_server/cursor-lights-control.png differ