AWS Cognito

What is mcp-server-aws-cognito?

mcp-server-aws-cognito is a Model Context Protocol (MCP) server implementation that connects to AWS Cognito for authentication and user management. It provides a set of tools for various user authentication flows.

How to use mcp-server-aws-cognito?

Prerequisites

• An AWS account with a Cognito User Pool configured.
• Node.js 18 or higher.

Installation

1. Clone the repository: git clone https://github.com/yourusername/mcp-server-aws-cognito.git
2. Navigate to the directory: cd mcp-server-aws-cognito
3. Install dependencies: npm install
4. Build the server: npm run build

AWS Cognito Configuration

1. Log in to your AWS Console and go to Amazon Cognito.
2. Create or use an existing User Pool.
3. Note your User Pool ID and App Client ID.
4. Set these as environment variables or in a .env file:

   AWS_COGNITO_USER_POOL_ID=your-user-pool-id
   AWS_COGNITO_USER_POOL_CLIENT_ID=your-app-client-id
   

Using with Claude Desktop

1. Ensure Node.js is installed.
2. Go to Settings > Developer > Edit Config in Claude Desktop.
3. Add the following to claude_desktop_config.json:

   {
     "mcpServers": {
       "aws-cognito-mcp-server": {
         "command": "/path/to/mcp-server-aws-cognito/build/index.js",
         "env": {
           "AWS_COGNITO_USER_POOL_ID": "your-user-pool-id",
           "AWS_COGNITO_USER_POOL_CLIENT_ID": "your-app-client-id"
         }
       }
     }
   }
   

Using with Claude Code

1. Install Claude Code.
2. Add the MCP server: claude mcp add "aws-cognito-mcp" npx tsx index.ts
3. Verify it's added: claude mcp list
4. Run Claude: claude

Development

• For auto-rebuild: npm run watch
• For debugging with MCP Inspector: npm run inspector

Key Features of mcp-server-aws-cognito

• User Authentication Flows: Supports sign-up, sign-in, password management, and more.
• Integration with AWS Cognito: Leverages AWS Cognito for robust user management.
• Comprehensive Toolset: Provides a variety of tools for common authentication tasks, including:
  • sign_up: Register a new user.
  • sign_up_confirm_code_from_email: Verify account with confirmation code.
  • sign_in: Authenticate a user.
  • sign_out: Sign out the current user.
  • getCurrentUser: Get the current signed-in user.
  • reset_password_send_code: Request password reset code.
  • reset_password_veryify_code: Reset password with verification code.
  • change_password: Change password for signed-in user.
  • refresh_session: Refresh authentication tokens.
  • update_user_attributes: Update user profile attributes.
  • delete_user: Delete the current signed-in user.
  • resend_confirmation_code: Resend account verification code.
  • verify_software_token: Verify TOTP for MFA.
• Debugging Tools: Provides access to debugging tools via the MCP Inspector.

Use Cases for mcp-server-aws-cognito

• Building Applications with User Authentication: Ideal for developers who need to integrate secure user authentication and management into their applications using AWS Cognito.
• Integrating with Claude: Seamlessly integrates with Claude Desktop and Claude Code for enhanced functionality and automation of authentication workflows.
• Rapid Prototyping: Quickly set up and test authentication flows during development.

FAQ about mcp-server-aws-cognito

Q: What are the prerequisites for using this server? A: You need an AWS account with a configured Cognito User Pool and Node.js 18 or higher.

Q: How do I configure AWS Cognito with this server? A: You need to create or use an existing User Pool in AWS Cognito and then set your User Pool ID and App Client ID as environment variables or in a .env file.

Q: Can I use this with Claude Desktop and Claude Code? A: Yes, detailed instructions are provided for integrating the server with both Claude Desktop and Claude Code.

Q: How can I debug the server? A: You can use the MCP Inspector by running npm run inspector to get better visibility into the server's operations.

Q: What kind of authentication flows does it support? A: It supports a wide range of authentication flows including sign-up, sign-in, password management, user attribute updates, and multi-factor authentication (MFA) verification.

AWS Cognito MCP Server

A Model Context Protocol (MCP) server implementation that connects to AWS Cognito for authentication and user management. This server provides a set of tools for user authentication flows including sign-up, sign-in, password management, and more.

Prerequisites

• AWS account with Cognito User Pool configured
• Node.js 18 or higher

Installation

# Clone the repository
git clone https://github.com/yourusername/mcp-server-aws-cognito.git

# Install dependencies
cd mcp-server-aws-cognito
npm install

# Build the server
npm run build

AWS Cognito Configuration

1. Log in to your AWS Console and navigate to Amazon Cognito
2. Create a User Pool or use an existing one
3. Note your User Pool ID and App Client ID
4. Set these values as environment variables or in a .env file (you need .env file only when you use claude code, not claude desktop):

AWS_COGNITO_USER_POOL_ID=your-user-pool-id
AWS_COGNITO_USER_POOL_CLIENT_ID=your-app-client-id

Available Tools

Tool Name	Description	Parameters
sign_up	Register a new user	email: string, password: string
sign_up_confirm_code_from_email	Verify account with confirmation code	username: string, confirmationCode: string
sign_in	Authenticate a user	username: string, password: string
sign_out	Sign out the current user	None
getCurrentUser	Get the current signed-in user	None
reset_password_send_code	Request password reset code	username: string
reset_password_veryify_code	Reset password with verification code	username: string, code: string, newPassword: string
change_password	Change password for signed-in user	oldPassword: string, newPassword: string
refresh_session	Refresh the authentication tokens	None
update_user_attributes	Update user profile attributes	attributes: Array of {name: string, value: string}
delete_user	Delete the current signed-in user	None
resend_confirmation_code	Resend account verification code	username: string
verify_software_token	Verify TOTP for MFA	username: string, totpCode: string

The Inspector will provide a URL to access debugging tools in your browser.

Using with Claude Desktop

Before starting make sure Node.js is installed on your desktop for npx to work.

1. Go to: Settings > Developer > Edit Config

2. Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "aws-cognito-mcp-server": {
      "command": "/path/to/mcp-server-aws-cognito/build/index.js",
      "env": {
        "AWS_COGNITO_USER_POOL_ID": "your-user-pool-id",
        "AWS_COGNITO_USER_POOL_CLIENT_ID": "your-app-client-id"
      }
    }
  }
}

Using with Claude Code

Claude Code is a command-line interface for Claude. To use this MCP server with Claude Code:

1. Install Claude Code by following the instructions at Claude Code Documentation

2. Add the MCP server to Claude Code:

claude mcp add "aws-cognito-mcp" npx tsx index.ts

3. Verify it's been added:

claude mcp list

4. Run Claude with your MCP server:

claude

Development

For development with auto-rebuild:

npm run watch

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. Use the MCP Inspector for better visibility:

npm run inspector

Now you can use the AWS Cognito authentication tools with Claude!