PlugWiki
cloudwatch-mcp-server logo

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

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

Lets your AI assistant read CloudWatch alarms, metrics and logs to find out why something in AWS is failing.

This is an AWS Labs server that runs on your computer and uses your AWS credentials. Its own description says it runs read-only commands to analyze CloudWatch logs, metrics and alarms.

You need an AWS account with CloudWatch data and a profile that can read it. The README says it can only run on the same machine as your AI app.

Good for

  • On-call engineers who want the assistant to dig through alarms and logs while they debug
  • Platform teams checking metric trends and getting alarm suggestions
  • Anyone who wants to query CloudWatch Logs without writing Insights syntax

Works in

12 should work

Tap an app to see how to set it up and any known problems.

Install cloudwatch-mcp-server

Claude Code

  1. 1

    Copy this prompt.

    Add the cloudwatch-mcp-server server to Claude Code. Run this command:
    
    claude mcp add cloudwatch -- uvx awslabs.cloudwatch-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

  • Lists the CloudWatch alarms that are firing now

    Finds the alarms currently in the ALARM state across your account and says which region was checked.

    Try: “Which CloudWatch alarms are firing right now in us-east-1?”

    Network · get_active_alarms

  • Shows how an alarm changed state over time

    Returns past state changes for one alarm, so the assistant can spot patterns such as flapping or a repeat time of day.

    Try: “Show the history of the HighCPU alarm for the last 3 days.”

    Network · get_alarm_history

  • Finds CloudWatch log groups and their settings

    Lists log groups and their metadata, optionally filtered by name, so the assistant can pick the right group to look into.

    Try: “Find the log groups that belong to my checkout service.”

    Network · describe_log_groups

  • Looks for anomalies and error patterns in a log group

    Analyzes one log group over a time window and reports anomalies, common message patterns and error patterns.

    Try: “Analyze /aws/lambda/orders for errors in the last hour.”

    Network · analyze_log_group

  • Starts a Logs Insights query

    Starts a Logs Insights query on one or more log groups for a time range. It returns a query ID that you use to fetch the results.

    Try: “Query the checkout log group for the 20 slowest requests today.”

    Network · execute_log_insights_query

  • Fetches the results of a Logs Insights query

    Returns the rows of a query started earlier, using its query ID.

    Try: “Get the results of the query I just started.”

    Network · get_logs_insight_query_results

  • Stops a Logs Insights query that is still running

    Cancels a query in progress. It only stops the query and does not touch your logs.

    Try: “Cancel that log query, it is taking too long.”

    Network · cancel_logs_insight_query

  • Runs one Logs Insights query across many log groups and regions

    Runs a single query over many log groups and regions, splits the work, retries failures and merges the rows into one result with warnings.

    Try: “Search all my production log groups in us-east-1 and eu-west-1 for ERROR in the last hour.”

    Network · execute_cwl_insights_batch

  • Suggests field indexes for one log group

    Looks at how a log group is queried and recommends fields to index so queries run faster.

    Try: “Which fields should I index on the payments log group?”

    Network · recommend_indexes_loggroup

  • Finds the log groups that would gain most from indexing

    Triage across your account: ranks which log groups would benefit from field indexing.

    Try: “Which of my log groups should I add indexes to first?”

    Network · recommend_indexes_account

  • Fetches CloudWatch metric values over time

    Retrieves data points for any metric by namespace, dimension and statistic. It can also compute percentiles, math expressions and several metrics in one call.

    Try: “Show p99 latency for my API Gateway over the last 6 hours.”

    Network · get_metric_data

  • Explains what a CloudWatch metric measures

    Returns a description of a metric, how it is calculated and which statistics suit it.

    Try: “What does the CPUCreditBalance metric mean?”

    Network · get_metric_metadata

Read from the source code

Permissions

low risk · 2 things to watch

Low risk

The assistant can read your alarms, metrics and log text, and no tool in the list creates or deletes anything. Use an AWS profile limited to the CloudWatch read permissions and the log groups you want to share.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • Log lines can contain secrets and personal data

    Query results go to your assistant and its provider. Scope the AWS profile to the log groups you are happy to share. github.com

  • Big queries can be slow and costly

    Logs Insights bills by data scanned. Ask for a short time range and a limit, and cancel queries that run long. github.com

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Turning on read-onlyNot needed: the server describes itself as read-only. Give the AWS identity only the permissions the README lists.
Talks toAmazon CloudWatch and CloudWatch Logs in the regions you query
Sign-in and keysUses your AWS credentials from a named AWS profile (AWS_PROFILE) or the standard AWS credential chain, plus an optional AWS_REGION.
Scopes
  • cloudwatch:DescribeAlarms

  • cloudwatch:DescribeAlarmHistory

  • cloudwatch:GetMetricData

  • cloudwatch:ListMetrics

  • logs:DescribeLogGroups

  • logs:DescribeQueryDefinitions

  • logs:ListLogAnomalyDetectors

  • logs:ListAnomalies

  • logs:StartQuery

  • logs:GetQueryResults

  • logs:StopQuery

Questions

Can it create or change alarms?

No. It suggests alarm settings but has no tool that creates, edits or deletes an alarm. It can start and stop Logs Insights queries, which does not change your logs.

Which AWS permissions does it need?

Read access to CloudWatch alarms and metrics, plus the Logs actions to describe log groups and to start, read and stop queries. The README lists eleven actions.

Does it run in the cloud or on my computer?

On your computer. The README says it can only run on the same machine as your AI app, using your own AWS credentials.

Can it search logs in several regions at once?

Yes. One tool runs a Logs Insights query across many log groups and regions in a single call and merges the results.

Do I need to know Logs Insights or PromQL?

No. Describe what you want and the assistant writes the query. PromQL tools matter only if you send OpenTelemetry metrics to CloudWatch.

Information

updated Nov 2, 2026

Publisher
Amazon Web Services (official)
Package
awslabs.cloudwatch-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 5
  1. CloudWatch MCP Server README · github.com
  2. CloudWatch server source · github.com
  3. CloudWatch Logs tools source · github.com
  4. CloudWatch Metrics tools source · github.com
  5. CloudWatch Alarms tools source · github.com

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