particle-mcp-server

Particle MCP Server

A Model Context Protocol server for the Particle IoT platform that enables AI assistants to manage Particle devices using natural language.

Features/API Endpoints Covered

Devices

• list_devices - lists all devices in your account
• list_product_devices - list all devices in a specified product
• rename_device - rename the device but keep the node_id the same
• add_device_notes - add notes to a device
• ping_device - pings the device to see if it is online
• call_function - calls a specified function on a particular device

Diagnostics

• get_device_vitals - gets the last known vitals from a specific device

Organizations

• list_organizations - lists all organizations apart of your account
• list_organization_products - lists all prodcuts within an organization

Product Firmware

• list_product_firmware - lists all firmware versions for a specific product id

Setup and Installation

create a .env file with the sctructure shown

# Particle API credentials
PARTICLE_ACCESS_TOKEN = your_api_token

to generate a particle api token, make sure the Particle CLI is installed and do this command:

particle token create

Usage

Clone this repo

Open Claude Desktop

Navigate to Settings

Click Developer

Click Edit Config

Paste this in:

{
    "mcpServers": {
        "particle": {
            "command": "uv",
            "args": [
                "--directory",
                "DIRECT/PATH/TO/particle-mcp-server",
                "run",
                "particle.py"
            ]
        }
    }
}

Contributing

https://docs.particle.io/reference/cloud-apis/api/#postman

Follow along to set up the Particle API environment in Postman, and implement a tool for each API endpoint. Open a PR with your changes for review! Please keep PRs "small"