Integrations

Integrations let the agent, and your bots, work with the services you use: look at your calendar, read and draft mail, check a channel, open an issue. Turn them on in Settings › Integrations, grouped as mail and calendar, chat, social, and code and work.

How each one connects

Each service works the best way it has, shown beside its name:

• Official: its maker’s own server. Click Connect, then Sign In… with your account.
• Official · your token or your app: its maker’s server, with a token you make (GitHub) or an app you register with the service (Slack, Gmail, Google Calendar, Asana, Zoom), whose ID and secret you paste. The sheet links to where you get them.
• Open source: a well-kept open-source server, pinned to a version, with a key you bring where it needs one. Kuvo Code runs it with Node if you have it, or with the engine’s own runtime otherwise.
• In the browser: there’s no server worth trusting, so the agent uses the site in the panel’s browser, signed in as you. Sign In… opens the site in a tab of Settings, next to the page. This Mac and each of your machines keep their own sign-ins: pick one at the top to sign in there. For X, LinkedIn and Reddit, Settings shows where you’re signed in. A bot on a machine also asks you to sign in when it needs to.

Keys stay in your Keychain and reach the engine only while it runs. Your Mac’s engine takes a new one right away; your machines’ engines restart to use it, and one that’s working waits until it’s done. The key you add here is shared by every session and bot; to give a bot a key only it uses, like a GitHub token of its own, add it under Keys in its Edit Bot.

Once one is connected, just ask: the agent uses the service’s own tools when you mention it, rather than its website. If it tries the website anyway, the browser sends it back to the tools; to have it open the website itself, say so.

Integrations work in every session and bot, on this Mac and on your machines: a sign-in you make here is copied to each machine’s engine and kept in step with it. Only Apple Calendar and Reminders stays on this Mac, as it uses this Mac’s apps: the first time, macOS asks to let Kuvo Code use your calendars and reminders. Under each one you see how it’s doing on this Mac and each machine, like “Connected on this Mac and lokum”, with a button when something needs you. Its ⋯ menu signs in again, changes the key, reconnects or removes it. Remove signs you out, here and on your machines, and deletes the key. For a server that isn’t listed, add it in MCP Servers.