Neat Pulse MCP Server

[!WARNING] This package is in early development and not yet officially supported. There may be bugs and issues. Breaking changes may occur between releases. Use at your own risk.

A Model Context Protocol (MCP) server for the Neat Pulse API. Allows AI tools like Claude Desktop and Cursor to manage your Neat devices directly.

Prerequisites

• Node.js v18 or later
• A Neat Pulse API token. Generate one in the Pulse portal under Settings → API Tokens

Installation

Claude Desktop / Cursor

Add the following to your Claude config (e.g., claude_desktop_config.json) or your Cursor MCP settings (e.g., ~/.cursor/mcp.json):

{
    "mcpServers": {
        "neat-pulse": {
            "command": "npx",
            "args": ["-y", "@neat-no/pulse-mcp@beta"],
            "env": {
                "PULSE_API_TOKEN": "your-api-token-here",
                "PULSE_ORG_ID": "your-org-id-here"
            }
        }
    }
}

Other clients

Any MCP-compatible client can run the server directly:

PULSE_API_TOKEN=your-api-token-here PULSE_ORG_ID=your-org-id-here npx @neat-no/pulse-mcp@beta

Configuration

| Environment variable | Required | Description | |-----------------------|----------|--------------------------------------------------| | PULSE_API_TOKEN | Yes | Your Neat Pulse API token | | PULSE_ORG_ID | Yes | Your Neat Pulse organization ID | | PULSE_API_BASE_URL | No | Override the API base URL (for testing) | | PULSE_WEB_BASE_URL | No | Override the Pulse web app base URL (for testing)|

Available tools

| Tool | Description | |------------------------|-----------------------------------------------------------------------------------------------------| | list_devices | List all Neat devices in the organization. | | get_device | Get full details for a Neat device, including the latest sensor readings. | | get_device_config | Get the current configuration for a Neat device. | | apply_device_config | Apply configuration settings to a Neat device. | | delete_device | Permanently delete a Neat device from the organization. | | move_device | Move a Neat device (and any devices paired to it) to a different room. | | reboot_device | Reboot a Neat device and any devices paired to it. | | list_rooms | List all rooms in the organization. | | get_room | Get details for a room, including the IDs of its devices and the latest sensor readings. | | create_room | Create a new room in the organization. | | update_room | Update a room's name and/or location. | | reset_enrolment_code | Reset the device-enrolment code for a room. | | delete_room | Permanently delete a room from the organization. | | list_locations | List all locations in the organization. | | list_regions | List all regions in the organization. | | open_remote_control | Open the Pulse remote control page for one or more Neat devices in the user's browser. |

Debugging

Use the MCP Inspector to test the server and browse available tools interactively:

PULSE_API_TOKEN=your-api-token-here PULSE_ORG_ID=your-org-id-here npx @modelcontextprotocol/inspector npx @neat-no/pulse-mcp@beta