PlugWiki
aws-iot-sitewise-mcp-server logo

AWS IoT SiteWise MCP Server: Setup for Claude, Cursor and Other Apps

Official · by Amazon Web ServicesLocal
GetPyPIawslabs.aws-iot-sitewise-mcp-serverawslabs/mcp/tree/HEAD/src/aws-iot-sitewise-mcp-server

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.

Install aws-iot-sitewise-mcp-server

Claude Code

  1. 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. 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_mode

  • Lists your SiteWise assets

    Lists assets in your account.

    Try: “List my SiteWise assets.”

    Read · list_assets

  • Shows details of one asset

    Returns an asset's properties, status and hierarchy.

    Try: “Describe the asset for pump 7.”

    Read · describe_asset

  • Lists asset models

    Lists the asset models that define your equipment types.

    Try: “Which asset models do I have?”

    Read · list_asset_models

  • Gets 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_value

  • Gets 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_history

  • Gets 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_aggregates

  • Runs 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_query

  • Lists your SiteWise gateways

    Lists the gateways that bring edge data into SiteWise.

    Try: “List my SiteWise gateways.”

    Read · list_gateways

  • Creates 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_asset

  • Writes 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_value

  • Deletes 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

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-onlyRead-only by default. Set SITEWISE_MCP_ALLOW_WRITES to True in the server environment to add the write tools.
Talks toAWS IoT SiteWise API in your AWS account and region
Sign-in and keysUses 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

GitHubDockerDocker 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 1
  1. aws-iot-sitewise MCP server README · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.