About Particle MCP Server
Particle MCP Server connects AI assistants to the Particle IoT platform for device and fleet management. It provides tools for device operations, diagnostics, organizations, products, and firmware.
Key features
- 01List devices and product devices
- 02Rename devices and add notes
- 03Ping devices and call functions
- 04Retrieve device vitals
- 05List organizations, products, and firmware
Use cases
- 01Check device availability and vitals
- 02Run a function on a Particle device
- 03Manage device names and notes
- 04Inspect organization products and firmware
MCP support
Exposes Particle platform operations as tools for MCP clients, including device management, diagnostics, organization and product listing, and firmware listing. Access requires a Particle API token.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project README
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"
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.