Skip to content
MCP server

Yaw Labs AWS MCP

AWS API access for AI assistants through your own CLI profiles, with in-chat SSO re-login

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
2.7.2
Listing updated
3 days ago

About Yaw Labs AWS MCP

Yaw Labs AWS MCP is an open-source MCP server for cloud and infrastructure. It runs locally on your machine and is started by your AI client.

Rather than a script sandbox, this server calls AWS one operation at a time through your local AWS CLI v2 and its profiles. aws_call takes a service, operation and params, so a client's approval prompt shows the actual operation. Its standout trick is SSO recovery: when a token has expired, the agent starts a device-code login, shows a URL and short code, waits for you to click, then carries on with the original question, using aws_login_start and aws_login_complete. aws_whoami reports account, ARN and token expiry countdown.

The README says it covers generic create, read, update and delete over more than 1,300 resource types through Cloud Control, with dry-run diffs that simulate a JSON Patch against current state without sending it to AWS. It also does multi-region and multi-account fan-out where partial failure is treated as normal, pre-flight IAM permission checks, live AWS documentation search and a JavaScript scripting tool for batched jobs, which is in-process and not a security sandbox. Session defaults for profile and region can be set once.

The README presents it as an alternative to AWS's own official MCP server, not something to run alongside it, and notes AWS Labs' per-service servers pair with either. It needs AWS CLI v2 (v1 is unsupported), uses AWS_PROFILE and AWS_REGION, installs from npm, is MIT licensed and is built by Yaw Labs.

Install

Run in a terminal

claude mcp add aws-mcp -- npx -y @yawlabs/aws-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "aws-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/aws-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "aws-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/aws-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "aws-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/aws-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "aws-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/aws-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "aws-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@yawlabs/aws-mcp"
      ]
    }
  }
}

Configuration

  • AWS_PROFILEAWS profile used when a tool call omits `profile`. Any profile your aws CLI can use (SSO, credential_process, role chaining, static keys). Unset: AWS_DEFAULT_PROFILE, then `default`.
  • AWS_REGIONRegion used when a tool call omits `region`. Unset: AWS_DEFAULT_REGION, then us-east-1 (a profile's own region setting is not read).

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

aws_whoami
Show account, ARN and SSO token expiry countdown.
aws_login_start
Start the device-code SSO login flow.
aws_login_complete
Finish the device-code SSO login.
aws_refresh_if_expiring_soon
Proactively refresh a token that is about to expire.
aws_call
Call one AWS operation by service, operation and params.
aws_assume_role
Assume a role and write the resulting profile.

What it does

In-chat SSO re-login
Starts a device-code login when a token expires and resumes the task after you click.
One operation per call
aws_call takes service, operation and params so approvals show the real action.
Cloud Control CRUD
Generic create, read, update and delete over 1,300+ resource types with dry-run diffs.
Multi-region fan-out
Runs one question across regions or accounts and returns per-region results.
Permission pre-checks
Checks IAM permissions before attempting a change.
Docs lookup and scripting
Searches AWS docs and offers a JavaScript tool for batched workflows.

Good for

  • Count objects in an S3 bucket even when the SSO token has expired
  • Switch between prod and a region for the rest of a session
  • Find every Lambda function above a memory threshold in one round trip
  • Preview a resource change before applying it

Pricing

Open source

MIT licensed; free to use

Prices change. Check yaw.sh before you buy.

Yaw Labs AWS MCP FAQ

What do I need installed?

AWS CLI v2 on your PATH and a profile for SSO or IAM Identity Center; v1 is unsupported.

Should I run it with AWS's official MCP server?

The README advises picking one, since both call any AWS API and would give the model two redundant tools.

How does it handle expired SSO?

It starts a device-code login, shows a URL and code, waits for you, then answers the original question.

What is the default region?

us-east-1 unless AWS_REGION or AWS_DEFAULT_REGION is set.

Is Yaw Labs AWS MCP free?

Yes. Yaw Labs AWS MCP is open source, so you can use and self-host it for free.

How do I add Yaw Labs AWS MCP to Claude Code?

Run this command in your terminal: claude mcp add aws-mcp -- npx -y @yawlabs/aws-mcp

What are the best alternatives to Yaw Labs AWS MCP?

The closest alternatives to Yaw Labs AWS MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Yaw Labs AWS MCP

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools