Hands-on Amazon Quick MCP Coding Agents Amazon Quick Desktop

Amazon Quick Desktop — I set it up and explored every feature. Here's everything.

Amazon Quick Desktop's app is more than a chat window. MCP server integration, coding agent delegation (Kiro, ClaudeCode, Cursor), local file indexing with semantic search, 26 built-in skills, voice mode, and a model picker with a Thinking toggle. I went through every setting and feature. Here's what it actually does.

VR
Vishnu Rachapudi Cloud & AI Engineer · AWS Community Builder (Security) · 14× AWS Certified
June 2026 · 12 min read
Section 01

What is Amazon Quick

Amazon Quick Desktop launched in preview in April 2026 for macOS and Windows. It extends Amazon Quick from the browser to your machine with a key architectural choice: local-first. The AI backend runs locally, your files stay on your computer, and the only network calls are to AI models via API Gateway and to your connected services (Slack, Outlook, Gmail, etc.). Your data doesn't leave your machine to be processed.

It's available to Plus and Enterprise accounts. Free accounts get a 30-day trial of the desktop app. Enterprise accounts get it across all supported AWS regions.

💡
What the desktop adds over the web version: Local file access (read/write/index without uploading), OS-level notifications, background processing with parallel tasks, browser automation (Chrome control), MCP server support, and coding agent delegation via ACP. The web version doesn't have any of these.

The MCP support is the headline feature for developers. Amazon Quick Desktop supports three ways to connect MCP servers — local servers running a command on your machine, remote servers over HTTP, and imported configurations from other tools like Kiro, Claude Code, or AIM. You can also export your config as JSON and share it across your team.

FeatureWebDesktop
Local file access
MCP server support
Coding agent delegation (ACP)
Browser automation
OS notifications
Background parallel tasks
Knowledge graph
Chat, Slack/Outlook/Gmail connectors
Section 02

Capabilities — local MCPs, remote MCPs, export as JSON

The Capabilities section is where you connect external tools. It has three tabs: Connectors, Schedules, and Tools. The MCP Servers section is the most important one — and it's more flexible than it looks.

🔌
Three ways to add MCP servers: Amazon Quick Desktop supports three MCP connection modes: local MCP servers (run a command on your machine), remote MCP servers over HTTP, and imported configurations from other tools — Kiro, Claude Code, AIM, or any MCP-compatible config file. You can also export your full config as JSON to share with your team or replicate across machines.

I connected AWS MCP as one example — it gives the agent 10 tools (7 read, 3 write) for working with AWS. But this is just one MCP server. You could connect any MCP-compatible server: your own internal tools, third-party services, anything running the MCP protocol locally or remotely.

Amazon Q Capabilities panel showing AWS MCP connected with 10 tools, and the permissions panel open showing read and write operations
Capabilities panel — AWS MCP connected as one example. Right panel shows per-tool permission controls: Always allow or Ask each time.
ToolTypeWhat it does
Aws Get TasksReadPoll status of long-running tasks
Aws Get Regional AvailabilityReadCheck AWS resource availability across regions
Aws List RegionsReadRetrieve all AWS regions
Aws Read DocumentationReadRead full AWS documentation pages
Aws RecommendReadGet content recommendations for an AWS docs page
Aws Retrieve SkillReadRetrieve domain-specific AWS agent skills
Aws Search DocumentationReadSearch across AWS documentation
Aws Call AwsWriteExecute AWS CLI commands
Aws Get Presigned UrlWriteGenerate pre-signed S3 URLs
Aws Run ScriptWriteRun scripts in your AWS environment

Each tool has a permission setting — Always allow or Ask each time. Read operations are set to Always allow by default; write operations default to Ask each time. That's the right default: you don't want the agent executing AWS CLI commands without a confirmation step.

Capabilities panel with AWS MCP and Kiro coding agent both connected and enabled
After connecting AWS MCP and adding Kiro as a coding agent — both active and toggled on.
Section 03

Coding Agents — Kiro, ClaudeCode, and more

This is one of the most interesting features. Amazon Quick Desktop can delegate coding tasks to external agents via ACP (Agent Client Protocol). You're not limited to Q's own coding capabilities — you can route work to whichever agent you prefer.

Add Coding Agent Skill dialog showing Kiro, ClaudeCode, Codex, Copilot, Gemini, and Cursor as options
The coding agent picker — 6 agents available. Kiro and ClaudeCode are installed; the rest require npm or brew install.
AgentStatusHow to install
KiroReadyPre-installed
ClaudeCodeReadyClaude Code via ACP wrapper — pre-installed
CodexNot installednpm i -g @zed-industries/codex-acp
CopilotNot installednpm i -g @github/copilot (Node 22+)
GeminiNot installednpm i -g @google/gemini-cli (Node 20+)
CursorNot installedcurl https://cursor.com/install-fsS | bash
How delegation works: When you tell Q to "use Kiro" or "have the agent code this", the Coding Agent Skill fires and routes the task via ACP to the selected agent. Amazon Quick Desktop acts as the orchestrator — it handles planning and context, the coding agent handles the actual code generation. You can also configure a custom ACP agent if none of these fit.
Section 04

Agents & Skills — 26 built-in

Under Agents & Skills → Skills, there are 26 built-in skills that ship with Amazon Quick. These are the capabilities the agent draws on when handling different types of requests.

Agents and Skills panel showing 26 built-in skills including Coding Agent Skills, Activity Feed, Schedule Management, Amazon Quick Guide, Web Browser, Documents
Agents & Skills → Skills tab. 26 built-in skills, all toggleable. Coding Agent Skills selected, showing it uses the Send Message To Acp Agent tool.
SkillToolsWhat it enables
Coding Agent Skills1Delegates coding work to ACP agents (Kiro, ClaudeCode, etc.)
Activity Feed9Work on items in the activity feed surface
Schedule Management17Create and manage recurring monitoring schedules
Amazon Quick Guide0Must-load for any Amazon Q question — loads Q-specific docs
Web Browser24Browse and interact with web pages via numbered elements
Documents4Enhanced operability with MS Word documents

Creating your own skills

You're not limited to the 26 built-in skills. The + Create button in the Skills panel lets you add your own — three ways:

Create skill dropdown showing Create with AI, Import from file, and Import URL options
Three ways to create a skill — generate with AI, import a file, or point to a URL.
OptionWhen to use it
Create with AIDescribe what you want the skill to do — Q writes the skill definition for you
Import from fileUpload an existing skill file from another machine or tool
Import URLPoint to a hosted skill definition — useful for team-shared skills

The Schedule Management skill (17 tools) is notable — it means you can ask Amazon Quick Desktop to set up recurring tasks directly from chat, without touching a config file. The Web Browser skill (24 tools) gives Q full web interaction capability, including clicking, form filling, and reading page content.

Section 05

My Computer — local file indexing

This is what separates the desktop app from any web-based AI tool. Under My Computer → Local Folders, you add folders the agent can access and index. I added my OneDrive folder — 25.27 GB, 34,210 files across 5,957 folders.

My Computer settings showing Local Folders section with OneDrive folder connected and a OneDrive folder detected warning
Local Folders — folder connected. The "OneDrive folder detected" warning prompts you to grant agent access and rescan to begin indexing.

For each folder you can enable three capabilities independently:

Folder settings showing Agent access, Keyword search at 4% indexing, Semantic search at 4% indexing, and Knowledge graph extraction option
Per-folder toggles — Agent access (read), Keyword search, Semantic search (both indexing at 4%), and Knowledge graph extraction.
ToggleWhat it does
Agent accessLets Q read and interact with files in this folder
Keyword searchBuilds a keyword index for fast text search across all files
Semantic searchBuilds an embedding index for meaning-based search (finds related content even without exact keyword matches)
Knowledge graph extractionExtracts entities and relationships — enables graph-level queries across your files
Search indexing settings showing 219.2 GB free disk space, 1 MB used, storage limit 4 GB, max file size 32 MB, max folder size 256 MB
Search indexing limits — 4 GB storage cap, 32 MB max file size, 256 MB max folder size. Indexing pauses if free disk space drops below 8 GB.
⚠️
Cloud folders need a manual rescan. OneDrive and network folders skip the automatic scan to avoid downloading placeholder files. You need to click "Rescan now" to start indexing. The status shows "Indexing 4%" until it completes.
Section 06

My Context — Knowledge graph & Memory

My Context has two tabs: Knowledge graph and Memory. These start empty but populate as you index files and use the agent. After indexing my OneDrive folder, both tabs had real data.

Knowledge graph

The knowledge graph extracts entities and relationships from your indexed files and renders them as an interactive node graph. After a partial index, it had already extracted two nodes — the folder itself and a person entity linked to it — with a directed relationship between them.

My Context Knowledge graph showing two nodes connected — a teal folder node and a yellow person entity node
Knowledge graph after partial indexing — two entities extracted, relationship mapped. Nodes are interactive; click to explore connections.

Memory

The Memory tab shows what Amazon Quick Desktop has learned and retained. After the folder analysis task, it had already stored one procedure — get_folder_size_summary(folder_path: str) — with a 70% confidence score. This is the agent learning a reusable tool from the task it just ran.

My Context Memory tab showing 1 procedure: get_folder_size_summary with 70% confidence score
Memory → 1 proc stored after one task. get_folder_size_summary(folder_path: str) at 70% confidence — Amazon Quick Desktop learned this from the folder analysis and will reuse it next time.
This is the compounding value. After one task, Amazon Quick Desktop already knows how to get folder sizes. Next time you ask, it won't figure it out from scratch — it'll reach for the stored procedure. The more you use it, the more it learns about how you work and what tools apply to your environment.
Section 07

The model picker — Fast, Balanced, Smart + Thinking

Clicking the model indicator in the chat input opens a three-option picker. The options map to different quality/speed tradeoffs — exactly what you'd expect.

Model picker showing Fast (optimized for speed), Balanced (balances quality and speed), Smart (highest quality) with a Thinking toggle
Model picker — three modes plus a Thinking toggle. Smart + Thinking on is the highest-quality, slowest option. Fast is for quick everyday tasks.
ModeBest for
Fast ⚡Quick lookups, simple questions, everyday tasks where speed matters
Balanced ⚖️Most tasks — good quality without the wait
Smart 🔵Complex analysis, architecture decisions, multi-step reasoning

The Thinking toggle (under Smart) enables extended reasoning — the model works through the problem step by step before responding. Worth turning on for anything architectural or ambiguous. Adds latency but meaningfully improves answer quality on hard questions.

Section 08

Quick in action — folder analysis

I asked Amazon Quick Desktop to check my folder size. First attempt — before granting agent access to the folder — it correctly told me it didn't have access and pointed me to the right setting.

Amazon Q chat showing it cannot access folders yet, then running code to list and calculate OneDrive folder size
After granting access — Amazon Quick Desktop lists the folder then runs code to calculate total size. You can see the tool calls: "Listing folder" then "Running code".

Once I enabled agent access and rescanned, it ran the analysis. The result:

Amazon Q response showing folder summary table: 25.27 GB total, 34,210 files, 5,957 folders
Folder summary returned in a clean table — 25.27 GB, 34,210 files, 5,957 folders. Q then offered to drill into subfolders or find the largest files.
What this shows: Amazon Quick Desktop doesn't just read files — it runs code on your machine to calculate things. The "Running code" step in the tool call log means it's executing a script locally, not just reading metadata. That's a meaningfully different capability from a web-based chat tool.
Section 09

Settings deep-dive

The settings panel is comprehensive. Here's everything worth knowing.

Browser settings

Browser settings showing Auto/Chrome/Edge/Brave options, Use my browser toggle, and Screenshot capture with Ctrl+Shift+Q shortcut
Browser config — choose which browser Q launches for web tasks, plus a screenshot capture shortcut (Ctrl+Shift+Q by default).

You can set which browser the agent uses for web tasks — Auto (system default), Chrome, Edge, or Brave. The Use my browser toggle is off by default, which means the agent launches a standalone browser with no access to your accounts or sessions. Turn it on if you want Q to use your actual logged-in browser context.

The Screenshot capture shortcut (default: Ctrl+Shift+Q) lets you select a screen region and send it directly to the agent — useful for debugging UI issues or sharing error messages without typing them out.

To-do management

Add to-do dialog with Title, Notes, and Priority fields (None, FYI, Important, Urgent)
The to-do dialog — four priority levels: None, FYI, Important, Urgent. Q can create and manage these from chat.

Amazon Quick Desktop has a built-in to-do system with four priority levels (None, FYI, Important, Urgent). You can ask Amazon Quick Desktop to create, update, or list to-dos from chat — or add them manually via the dialog. These integrate with the Activity Feed skill.

Performance & Response preferences

Performance settings showing max parallel tasks slider at 20, Response preferences text field, and Updates section with auto-download toggles
Performance config — max 20 parallel extraction tasks (range 1-50). Response preferences let you set global instructions that apply across all agents.

The Response preferences field is a global instruction that gets included with every message across all agents — like a persistent system prompt you control. Set it to "Be concise", "Always include code examples", "Respond in bullet points" — whatever fits your workflow.

The Max parallel tasks slider (1-50, default 20) controls how many concurrent extraction tasks run during batch operations like indexing large folders.

Voice — Dictation + Talkback

Voice settings showing Skill preloading toggle, Dictation with microphone selector, and Talkback with Matthew Male US English voice at 1.10x speed
Voice settings — Dictation (speak to type) and Talkback (Q speaks responses aloud). Matthew, Male, US English at 1.10×. Live mode keeps the mic open.

Voice has two modes. Dictation is speak-to-type — you talk, Q transcribes, you hit Send. Talkback is Q speaking its responses aloud, with a choice of voice, speed, and Live mode (mic stays open so you can interrupt mid-response by saying 3+ words).

There's also a Skill preloading toggle — when on, Amazon Quick Desktop classifies each query before planning and pre-activates the predicted skills. Reduces latency by front-loading skill selection.

Troubleshooting & Data

Troubleshooting showing Export Diagnostics button and Danger zone with Clear all data option in red
Troubleshooting — export diagnostic logs for the last 2 hours (or other windows). Danger zone: Clear all data removes all conversations, knowledge graph, credentials, and preferences.

Export Diagnostics saves logs to your Desktop — useful for filing bug reports. The Danger zone clear wipes everything: conversations, cached messages, knowledge graph, saved credentials, and preferences. The app quits after cleanup. To fully uninstall, drag the app to Trash after clearing data.

Section 10

Honest takeaways

A few things that stood out after going through everything:

The MCP + coding agent combination is the real value. AWS MCP gives Q direct access to your AWS environment. Coding agents (Kiro, ClaudeCode) give it the ability to write and run code. Together, they make Q a genuine automation layer — not just a chat interface on top of documentation.

Local file indexing with semantic search is underrated. The ability to ask questions over your entire local file system — with embedding-based search finding relevant content even without exact keyword matches — is genuinely useful for anyone working with large codebases, documentation sets, or project files.

The Response preferences field is worth filling in immediately. It's a global system prompt you control. Set your formatting preferences, language, verbosity level once and never think about it again across all agents.

Write operations default to Ask each time — keep it that way. The AWS MCP write tools (Call Aws, Run Script, Get Presigned Url) are all set to Ask each time by default. Don't change them to Always allow. The extra confirmation step is the right guardrail when the agent has AWS CLI access.

🚀
Get started: Download Amazon Quick Desktop from aws.amazon.com/q. Connect AWS MCP first — it's the highest-value integration and takes 2 minutes. Then add your most-used local folder and enable semantic search. Those two steps alone make it significantly more useful than any web-based AI tool for AWS work.