aws-sso-refresh

Refreshes expired AWS SSO tokens for credential recovery in macro tools.

Updated Nov 25, 2025
One-click install
npx skills add https://github.com/veelenga/aws-sso-mcp --skill aws-sso-refresh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aws-sso-refresh
Source: https://github.com/veelenga/aws-sso-mcp/tree/main/skills/aws-sso-refresh
Command: npx skills add https://github.com/veelenga/aws-sso-mcp --skill aws-sso-refresh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the frustration and downtime caused by expired AWS SSO authentication tokens. It automatically detects token expiration errors and initiates the refresh process, ensuring your AWS operations continue uninterrupted.

Core Features & Use Cases

  • Automatic Token Refresh: Detects AWS SSO token expiration and triggers a browser-based re-authentication flow.
  • Smart Profile Resolution: Automatically identifies the correct AWS profile from various MCP client configurations (Claude Code, Cursor, VS Code, etc.).
  • Seamless Workflow Recovery: After refreshing, it enables immediate retry of failed AWS operations, saving you from manual troubleshooting and re-running commands.
  • Use Case: When your AI assistant encounters an "ExpiredTokenException" during an AWS operation, this Skill can be invoked to refresh the session, allowing the original task to complete successfully without manual intervention.

Quick Start

My AWS operation failed due to an expired SSO token for the 'bedrock-kb' server. Please refresh my AWS SSO session.

Frequently Asked Questions about aws-sso-refresh

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I refresh an expired AWS SSO token?

Refreshing an expired AWS SSO token involves detecting the token expiration error and initiating a browser-based re-authentication flow. This Skill automatically identifies the correct AWS profile from your MCP client configuration and prompts you to complete browser login, restoring access without manual intervention.

Can I automatically detect and fix AWS SSO token expiration errors?

Yes. This Skill detects AWS SSO token expiration errors—including ExpiredTokenException and refresh failures—automatically resolves the correct AWS profile across multiple MCP client configurations, and triggers browser-based re-authentication to restore your session.

What happens when my AWS operation fails with an expired token?

When an AWS operation fails due to an expired SSO token, this Skill can be invoked to refresh the session by launching browser-based authentication for the matched profile. After successful refresh, your original AWS operation can retry immediately without manual re-running.

How does this Skill find the right AWS profile for token refresh?

The Skill performs smart profile resolution by automatically detecting the correct AWS profile from various MCP client configurations—including Claude Code, Cursor, and VS Code. It searches multiple MCP config locations and matches the profile to restore token access seamlessly.

Do I need to manually re-authenticate after SSO token expiration?

No. This Skill eliminates manual re-authentication by automating the entire process: it detects expiration, identifies your AWS profile, and prompts you to complete browser login once. Your session is restored, and failed operations can proceed without repeating commands.