Skip to main content

Check out a video walkthrough showing AI with Sonto

Get introduced to AI in Sonto.
If you use agentic AI tools like Claude, ChatGPT, Codex, or Craft Agents, you can connect them to Sonto. Once connected, your AI tool can read your Sonto data (like your inbox, today, and your projects) and — if you allow it — help you make changes (like creating tasks or updating plans). Sonto connects through MCP, an open standard that many agentic tools support, and getting started takes a minute. So what can you do?
  • Quick context: get a briefing of today, this week, or a specific project.
  • Search and review: find tasks, check long-term plans, and spot what’s stuck.
  • Plan with more context: connect other information sources to your agent for assisted goalsetting.
  • Hands-on changes: create and update tasks/projects/areas/groups, and manage yearly/quarterly plans.
Some prompts to get you started:
  • “What does today look like in Sonto? Include events.”
  • “Open my current week and highlight anything overdue.”
  • “Get my action items from these meeting notes and add them to the Summer Promo project in Sonto.”

​
Turn it on

AI access is included in the Mac version of Sonto.
AI Access is on by default, in read-only mode. To check or change it, open Settings → AI:
  • AI Access — the main switch. When off, no AI tool can reach Sonto (this includes the sonto CLI).
  • Allow changes — off by default. Turn it on to let AI create, edit and complete items. Leave it off and AI can only read.
Allowing changes lets your AI tool edit Sonto, including deleting data. Start read-only, and turn on Allow changes once you trust your setup.
Your private event notes follow the same two switches: with AI Access on, AI tools can read them, and with Allow changes on they can write them too. Connected AI tools send what they read to their provider.

​
Connect Claude or ChatGPT

​
Claude Desktop

Open Settings → AI and click Install Claude Desktop Connector. Claude Desktop opens and offers to install it — accept, and you’re done.

​
ChatGPT

Needs the ChatGPT desktop app for Mac.
Open Settings → AI and click Install ChatGPT Plugin:
1

Allow the folder (first time only)

A window opens on the .agents folder in your home folder — click Allow. That’s where ChatGPT looks for plugins.
2

Install the plugin

ChatGPT opens on Sonto’s plugin page. Click Install plugin.
3

Ask away

In a new chat, type @Sonto and ask, for example, “What’s on my plate today?”
The first time, ChatGPT asks to run the sontocli command — allow it. Sonto has to be running, and the plugin works in the ChatGPT app on your Mac, not on the web or your phone.

​
CLI and other tools

Using Claude Code, Codex or another coding agent? The Sonto CLI is the lightest way to give it access, with no connector. Any tool that supports MCP can connect to Sonto’s local server. Open Use the CLI or connect to other AI Agents in Settings → AI to find the endpoint (by default http://127.0.0.1:2402/) and the pairing code your tool asks for during sign-in. The code refreshes every ten minutes.
Then run claude, open /mcp, select sonto and authenticate with the pairing code.
Connected tools are listed on the same page, where you can Disconnect any of them.
Read: get_inbox, get_day, get_day_events, get_week, get_project, get_area, list_projects, list_areas, list_groups, list_long_term_plans, get_long_term_plan, search_todos, get_event_notes.Write (with Allow changes): add_task, edit_task, delete_task, sort_tasks, bulk_edit_tasks, bulk_delete_tasks, schedule_task_event, set_event_notes, the project, area and group tools, edit_day, edit_week, delete_completed_todos, and the long-term plan tools. Destructive actions ask for confirmation.Prompts: day_brief, week_brief, day_plan, week_plan, inbox_triage, project_review, the ltp_* plan prompts, and meeting_prep, which drafts an agenda in your private notes and asks before saving it.Resources such as sonto://context/today give clients a read-only snapshot to preload.