
AWS IoT SiteWise MCP Server: Setup for Claude, Cursor and Other Apps
Lets your assistant browse your AWS IoT SiteWise assets and read their sensor data, with optional tools to change them.
This is the AWS Labs server for AWS IoT SiteWise. It runs on your computer and uses your AWS profile to look at assets, asset models, gateways and property values, and to run SiteWise queries.
It starts with only the read tools. Set SITEWISE_MCP_ALLOW_WRITES to True to add the tools that create, update and delete assets, models, gateways and data.
Good for
- Industrial engineers who check equipment readings from chat
- Data teams who query SiteWise history and aggregates
- IoT developers who set up assets and models and want a faster loop
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install aws-iot-sitewise-mcp-server
Claude Code
- 1
Copy this prompt.
Add the aws-iot-sitewise-mcp-server server to Claude Code. Run this command: claude mcp add aws-iot-sitewise -- uvx awslabs.aws-iot-sitewise-mcp-server Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires uv (Python).
Built from the package data we hold. Not yet tested by us.
Tools
Shows whether writes are on
Reports the server's current mode and how to turn on write tools.
Try: “Is the SiteWise server in read-only mode?”
Read ·
get_sitewise_server_modeLists your SiteWise assets
Lists assets in your account.
Try: “List my SiteWise assets.”
Read ·
list_assetsShows details of one asset
Returns an asset's properties, status and hierarchy.
Try: “Describe the asset for pump 7.”
Read ·
describe_assetLists asset models
Lists the asset models that define your equipment types.
Try: “Which asset models do I have?”
Read ·
list_asset_modelsGets the latest value of a property
Returns the current value of one asset property, such as a temperature.
Try: “What is the current temperature on pump 7?”
Read ·
get_asset_property_valueGets past values of a property
Returns historical values of a property over a time range.
Try: “Show pump 7's temperature for the last 24 hours.”
Read ·
get_asset_property_value_historyGets averages and totals over time
Returns aggregates such as average, minimum and maximum for a property.
Try: “What was the hourly average vibration on pump 7 yesterday?”
Read ·
get_asset_property_aggregatesRuns a SQL query on SiteWise data
Runs a SQL query against SiteWise data and returns the rows.
Try: “Query the 10 assets with the highest temperature right now.”
Read ·
execute_queryLists your SiteWise gateways
Lists the gateways that bring edge data into SiteWise.
Try: “List my SiteWise gateways.”
Read ·
list_gatewaysCreates an asset
Creates a new asset from an asset model. Only available when writes are enabled.
Try: “Create an asset for pump 8 from the pump model.”
Write ·
create_assetWrites property values
Sends new data points to asset properties. Only available when writes are enabled.
Try: “Add these three temperature readings to pump 7.”
Write ·
batch_put_asset_property_valueDeletes an asset
Removes an asset. Only available when writes are enabled.
Try: “Delete the test asset named pump-test.”
Delete ·
delete_asset
Read from the source code
Permissions
low risk · 2 things to watch
Low risk
By default only read tools are available, but with SITEWISE_MCP_ALLOW_WRITES on the server can also create, change and delete assets, models, gateways and data.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only modeHow to turn it on
Watch out for
With writes on it can delete assets and gateways
Delete tools remove equipment records and connections. Keep writes off unless you need them.
It can write data points into your assets
Write mode lets the assistant send values to asset properties, which can distort your history.
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | Read-only by default. Set SITEWISE_MCP_ALLOW_WRITES to True in the server environment to add the write tools. |
|---|---|
| Talks to | AWS IoT SiteWise API in your AWS account and region |
| Sign-in and keys | Uses your AWS profile or access keys from your computer. |
Questions
Can it run read-only?
Yes, and that is the default. Write tools are not even offered until you set SITEWISE_MCP_ALLOW_WRITES to True.
How do I turn on writes?
Set the SITEWISE_MCP_ALLOW_WRITES environment variable to True in the server settings and restart the app.
Is this the full tool list?
No. The server has more than 70 tools in total and this page lists a representative set.
Does it need an AWS account?
Yes. It uses your AWS profile or access keys, and your IAM user needs IoT SiteWise permissions. Set the AWS region too.
Does it run on my computer or in the cloud?
It runs on your computer and calls AWS from there.
Which apps can use it?
Any app that runs local servers, such as Claude Code, Claude Desktop, Cursor and VS Code. The install box shows the setup for each.
Information
updated Nov 2, 2026
- Publisher
- Amazon Web Services (official)
- Package
awslabs.aws-iot-sitewise-mcp-server- Registry
- PyPI
- Transport
- stdio
- License
- Apache-2.0
- Last commit
- Oct 30, 2026
- Open issues
- 143
- Listed in
- Docker MCP Catalog
Other AWS MCP servers
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 1Hide
- aws-iot-sitewise MCP server README · github.com