Amazon Q Business — Claude Code MCP server: what it does
This MCP server sends queries to an Amazon Q Business application and returns answers based on its ingested content. It requires an anonymous-mode application and configured AWS access.
Apache-2.0 ★ 9,939 updated 2026-10-23
Open on GitHubWhat Amazon Q Business does
The server exposes QBusinessQueryTool. An agent passes a query to the tool, which asks the Amazon Q Business application for a response based on content already ingested there. It supports applications created with anonymous-mode access.
To run it, install uv and Python with uv python install 3.10, create an Amazon Q Business application, and configure AWS credentials with aws configure. The IAM user needs at least the qbusiness:ChatSync permission. Requests will fail without the application and AWS access set up.
Add the server to your MCP client configuration. The standard setup runs the package with uvx; a Windows example uses uv tool run. Configuration includes the application ID, AWS profile, and region. A Docker option is also shown, and temporary AWS credentials must be refreshed on the host.
What it helps with
- query content ingested into Amazon Q Business
- retrieve project details through an application query
- give an agent context from an Amazon Q Business application
Example prompts for the agent
- Find the project details in my Amazon Q Business application.
- Answer this using content ingested into Amazon Q Business.
- Ask Amazon Q Business for context relevant to this question.
How to install Amazon Q Business
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 Amazon Q Business
How do I install Amazon Q Business in Claude Code?
No Claude Code install command is provided. Add the server to the client's MCP configuration, launch it with uvx, and set the application and AWS parameters.
What does the Amazon Q Business MCP server do?
It exposes QBusinessQueryTool, which queries an Amazon Q Business application and returns an answer based on content ingested into that application.
What does the Amazon Q Business MCP server need to run?
It requires an AWS account, an anonymous-mode Amazon Q Business application, uv, Python, and an AWS profile. The IAM user needs at least qbusiness:ChatSync permission.