AWS IAM — Claude Code MCP server: what it does, how to install
An MCP server that lets your agent create and edit AWS IAM users, roles, groups and policies, with a simulator to test permissions before anything changes.
Apache-2.0 ★ 9,939 updated 2026-10-23
Open on GitHubWhat AWS IAM does
The server hands the agent tools for everyday IAM work: add a user, build a role with a trust policy, move people between groups, attach or detach a policy, issue and revoke access keys. Inline policies on users and roles can be created, read and deleted as well.
The package is awslabs.iam-mcp-server, installed with uv or pip. In an MCP client such as Cursor, Cline or Zed you register it as uvx awslabs.iam-mcp-server@latest and pass AWS_PROFILE and AWS_REGION in the env block. Windows takes a different entry: uv with tool run --from ... and the .exe name.
Credentials are mandatory. A named profile, a key pair in environment variables or an instance role on EC2 and Lambda all work. The identity behind them needs a broad set of iam:* actions covering reads, creates and deletes; a trimmed policy makes those calls fail. Simulate a change before you apply it, and read-only mode blocks edits entirely.
What it helps with
- create an IAM user and hand out an access key
- stand up a role with a trust policy without hand-writing JSON
- test a permission in the simulator before it goes live
- remove a user together with everything attached to it
- keep permissions in groups instead of per-user attachments
Example prompts for the agent
- List every IAM user in the account and the policies attached to each
- Create a role
deploy-rolethat EC2 can assume and attach an S3 read policy to it - Simulate whether the user
ci-botcan delete objects in the bucket
How to install AWS IAM
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about AWS IAM
How do I install AWS IAM in Claude Code?
Run uv tool install awslabs.iam-mcp-server. Then add the server to your MCP client config with uvx awslabs.iam-mcp-server@latest and set AWS_PROFILE and AWS_REGION in the env block.
What does AWS IAM do?
It exposes IAM operations to the agent: users, roles with trust policies, groups, managed and inline policies, access keys. A simulator lets you check permissions before they take effect.
Which AWS permissions does the server need?
A set of iam:* actions covering reads, creates and deletes for users, roles, groups and policies, plus policy attach and detach and access key handling. A trimmed policy makes the matching calls fail.