> ## Documentation Index
> Fetch the complete documentation index at: https://help.sonto.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Using AI with Sonto

> Connect Sonto to your AI tools with MCP

Sonto for Mac has a built-in **MCP server**, so you can connect it to agentic AI tools like Claude Code,
OpenAI Codex, or Craft Agents. Once connected, your AI can **read** your Sonto data and — if you allow
it — **write** to Sonto too: creating tasks, building a plan, scheduling work. AI can do the work; Sonto
stays the place where you decide what work matters. Watch below, or read the written steps that follow.

<Frame caption="Getting started with AI in Sonto">
  <iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/Nb7VUd51n0E" title="YouTube video player" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen style={{ width: '100%', borderRadius: '0.5rem' }} />
</Frame>

<Info>
  The MCP server runs on **Mac** only.
</Info>

## Turn on the MCP server

Open **Settings → AI** and toggle the **MCP server** on. There are two modes:

* **Read-only** — your AI can see your data but not change it. The safe default.
* **Read and write** — the full experience: your AI can create and update tasks and plans. Switch to
  this when you're ready.

## Connect your AI tool

<Steps>
  <Step title="Grab the command for your tool">
    The [Connect to AI Agents](/reference/ai-with-mcp) reference has a ready-made command for each tool
    (Claude Code, OpenAI Codex, and others). Copy the one for yours.
  </Step>

  <Step title="Run it and pair">
    Paste the command into your terminal. A browser window opens asking for a **pairing code**. Find the
    code in **Settings → AI**, just below the endpoint, copy it in, and authorise.
  </Step>

  <Step title="Confirm the connection">
    Back in **Settings → AI**, your tool now shows as a connected client. You can disconnect it any time
    — that instantly revokes its access — or toggle the server off entirely to stop all connections.
  </Step>
</Steps>

## Put it to work

In your AI tool, check that Sonto is connected (in Codex, `/mcp` lists Sonto and its tools). Then just
ask in plain language. For example:

> Create a long-term plan in Sonto for 2026. Add three groups — health, wealth, wise — and a few goals
> in each.

The AI works out which Sonto tools to call and builds the plan, groups, and goals for you. Beyond
long-term plans, it can help plan your week or day, read your existing plans and calendar, and schedule
tasks — most of what you can do in Sonto, it can do for you.

## Where to next

<CardGroup cols={2}>
  <Card title="Connect to AI Agents" icon="robot" href="/reference/ai-with-mcp">
    Per-tool setup commands and the full tool list.
  </Card>

  <Card title="Export as Markdown" icon="file-export" href="/reference/markdown-export">
    Hand a plan to an AI as text, no setup needed.
  </Card>
</CardGroup>