documentation/docs/mcp/sugar-mcp.mdx
import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; import CLIExtensionInstructions from '@site/src/components/CLIExtensionInstructions'; import GooseDesktopInstaller from '@site/src/components/GooseDesktopInstaller';
This tutorial covers how to add the Sugar MCP Server as a goose extension to delegate development tasks to an autonomous AI system that runs in the background.
:::tip Quick Install <Tabs groupId="interface"> <TabItem value="ui" label="goose Desktop" default> Launch the installer
When prompted, set SUGAR_PROJECT_ROOT to your project path.
</TabItem>
<TabItem value="cli" label="goose CLI">
Command
npx -y sugarai-mcp
Runs in your current directory by default. </TabItem> </Tabs> :::
:::info
Note that you'll need Node.js installed on your system to run this command, as it uses npx.
:::
:::info
Sugar requires Python 3.11+ and the Sugar CLI installed in your project. Install with pip install sugarai and initialize with sugar init.
:::
Sugar lets you delegate development tasks to an autonomous AI that works in the background. Tasks are queued and executed independently, so you can continue working while Sugar handles them.
<Tabs groupId="interface"> <TabItem value="ui" label="goose Desktop" default> 1. Open a new session in goose Desktop </TabItem> <TabItem value="cli" label="goose CLI">goose session
Create a task to add input validation to the user registration form. Priority 4.
:::note Desktop
I'll create a Sugar task for adding input validation to the user registration form.
-------- createTask -------
Task created successfully:
The task has been queued. Sugar will pick it up and work on it autonomously. You can check the status anytime with getStatus or listTasks.
:::
Sugar exposes the following tools through MCP:
| Tool | Description |
|---|---|
createTask | Create a new development task |
listTasks | List tasks with optional filtering |
viewTask | View detailed task information |
updateTask | Update task properties |
removeTask | Remove a task from the queue |
getStatus | Get system status and metrics |
runOnce | Execute one autonomous development cycle |
initSugar | Initialize Sugar in a project |