Amazon Q Business MCP Server (Anonymous Mode): Setup for Claude and Other Apps
awslabs.amazon-qbusiness-anonymous-mcp-serverawslabs/mcp/tree/HEAD/src/amazon-qbusiness-anonymous-mcp-serverLets your AI assistant ask an Amazon Q Business app questions and get answers based on the content you loaded into it.
This is an AWS Labs server that runs on your computer. It sends your question to one Amazon Q Business application and passes the answer back to your assistant. It uses your own AWS credentials.
It works only with Q Business applications created in anonymous mode. You need the application ID and its AWS region.
Good for
- Teams that already run an Amazon Q Business app and want to query it from Claude or Cursor
- Developers who want company knowledge from Q Business as context while coding
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install amazon-qbusiness-anonymous-mcp-server
Claude Code
- 1
Copy this prompt.
Add the amazon-qbusiness-anonymous-mcp-server server to Claude Code. Run this command: claude mcp add amazon-qbusiness-anonymous -e QBUSINESS_APPLICATION_ID=<QBUSINESS_APPLICATION_ID> -e AWS_REGION=<AWS_REGION> -- uvx awslabs.amazon-qbusiness-anonymous-mcp-server Ask me for QBUSINESS_APPLICATION_ID, AWS_REGION and only put the values in that config, nowhere else. Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires uv (Python).
Built from the package data we hold. Not yet tested by us.
Tools
Asks your Amazon Q Business app a question
Sends your question to the Q Business application and returns its answer, which is based on the content you loaded into that app. It returns an error if the question is empty.
Try: “Can you get me the details of the ACME project? Use the QBusinessQueryTool to get the context.”
Network ·
QBusinessQueryTool
Read from the source code
Permissions
low risk · 2 things to watch
Low risk
The assistant can only ask questions of one Q Business app and read its answers. Give the AWS user only the ChatSync permission.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only mode
Watch out for
Your questions go to Amazon Q Business
Each question is sent to the Q Business application you configure, and the answer goes to your assistant. Do not point it at an app holding content you would not share with the assistant. github.com
Only anonymous-mode apps are supported
Apps that need signed-in users will not work with this server. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | Not needed: the one tool only asks questions. Give the AWS user only the qbusiness:ChatSync permission. |
|---|---|
| Talks to | Amazon Q Business in your AWS region |
| Sign-in and keys | Uses your AWS credentials from an AWS profile (aws configure) or environment variables. The server keeps no separate account. |
| Scopes |
|
Questions
What is Q Business anonymous mode?
It is an Amazon Q Business application setting where users do not sign in. AWS describes how to create one in the Q Business user guide, and this server works only with apps made that way.
What do I need before I install it?
An AWS account, an Amazon Q Business application created in anonymous mode with your content loaded, its application ID and region, AWS credentials from aws configure, and uv.
Which AWS permission does it need?
At minimum qbusiness:ChatSync. The README advises least privilege.
Can it change my Q Business app?
Its only tool asks a question and returns the answer. It has no tool to edit the app or its content.
Which package name do I use?
The package is awslabs.amazon-qbusiness-anonymous-mcp-server, as in the install box. One example in the README shows a shorter name without "amazon" in it, which is a mistake in that example.
Information
updated Nov 2, 2026
- Publisher
- Amazon Web Services (official)
- Package
awslabs.amazon-qbusiness-anonymous-mcp-server- Registry
- PyPI
- Transport
- stdio
- Auth
- token in env
- License
- Apache-2.0
- Last commit
- Oct 30, 2026
- Open issues
- 143
- Listed in
- Docker MCP Catalog
Other AWS MCP servers
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 3Hide
- Amazon Q Business anonymous MCP Server README · github.com
- Q Business server source · github.com
- Q Business client source · github.com