aaif-goose--goose/documentation/docs/guides/interactive-chat/mcp-ui.md

sidebar_position, title, sidebar_label, description

sidebar_position	title	sidebar_label	description
1	Using MCP Apps	Using MCP Apps	Learn how goose renders interactive UI components from MCP Apps extensions

import { PanelLeft } from 'lucide-react';

Using MCP Apps

Extensions built with MCP Apps allow goose Desktop to provide interactive and engaging user experiences. Instead of reading text responses and typing prompts, you can interact with a graphical and clickable UI.

:::info MCP Apps is the official specification MCP Apps is the official MCP specification for interactive UIs. Use MCP Apps for new interactive extensions. :::

:::warning Experimental Features The features described in this topic are experimental and in active development. Behavior and support may change in future releases. :::

MCP Apps bring interactive interfaces to goose through the official MCP Apps specification. Depending on the extension, apps can be launched in standalone, sandboxed windows or embedded in your chat window.

Launching Apps in Standalone Windows

Some MCP Apps can be launched in their own windows, allowing you to jump straight to the interface without sending messages to goose.

1. Click the button in the top-left to open the sidebar
2. Click Apps in the sidebar
3. Browse your available MCP Apps
4. Click Launch to launch an app in a new window

:::info Apps Extension To see the Apps page in the sidebar, the Apps extension must be enabled from the Extensions page. You can also use it to create custom standalone apps. :::

The Apps page displays custom HTML apps you created using the Apps extension, imported HTML apps, and apps from your enabled MCP Apps extensions. The app interface lets you click buttons, fill forms, or use other controls. Apps can call tools and read resources through MCP (if enabled through CORS), but cannot communicate with goose (e.g. via chat).

Import an HTML App

Import apps that were created with the Apps extension and shared with you.

1. Click the button in the top-left to open the sidebar
2. Click Apps in the sidebar
3. Click Import App, browse to the app's .html file on your file system, and click Open

Using Apps in Chat Windows

Some MCP Apps render directly in your conversation when goose calls a tool that returns UI. The interactive interface appears inline with the chat, letting you make selections, fill forms, or trigger actions without leaving the conversation flow.

If needed, you can just ask goose whether the UI can be loaded in the chat window.

For Extension Developers

Add interactivity to your own extensions:

• Building MCP Apps - Step-by-step tutorial (recommended)
• MCP Apps SDK and Specification
• MCP Apps SDK Guide