Get Started

Kuuumba replaces the pile of tabs (email, chat, tasks, docs, calls) with one fast, keyboard-driven workspace. This guide takes you from a fresh account to a working setup.

Prefer a guided tour?Book a live onboarding call and a member of our team will walk you through setup and answer questions.

1. Connect your email

Kuuumba is not an email server, it's just an email client. It syncs with your existing Gmail or Google Workspace account, so your mail stays in Gmail. We recommend connecting your account during signup so your inbox is ready from the first minute.

Have more than one address? Add additional Gmail or Google Workspace accounts in Settings, and they all flow into a single unified inbox. When you compose, you choose which address to send from.

2. Learn five keys

Kuuumba is built keyboard-first. These five get you most of the way:

Key	What it does
c	Open the create launcher, then d for a doc, t for a task, e for an email, m for a message, a for an AI chat
cmd+k	Command menu to jump to anything by name
/	Unified search across email, docs, tasks, messages, calls, and files
j / k	Move down / up in any list
e	Mark done: archive an email, clear an inbox item

The full list lives in Keyboard shortcuts.

3. Triage from one inbox

Press g + i to open the unified inbox. Emails, channel messages, task assignments, @mentions, and agent responses all land here, split into Signal (needs your attention) and Noise (everything else).

Work the list with j / k, preview with space, and clear items with e. The list shrinks as you go.

4. Open work side by side

Kuuumba has its own window manager. Press cmd+\ to create a split, and shift+enter to open any list item or @mention in a new split, for example your inbox on the left and the doc someone sent you on the right. Move focus with shift+h / shift+l, maximize with shift+escape. More in Blocks.

5. Create a team

Click Team in the bottom left to create one. Teams exist to help you collaborate better as a group:

• Auto-sharing: tasks are visible to the whole team, and calls are recorded, transcribed, and shared by default. No "can you share that with me?" requests.
• Team memory: agents remember what your whole team is doing across email, messages, tasks, docs, and calls, not just your own chats.

Then create a channel per team or project (c + m). Channels are also how permissions work in Kuuumba: anything you @mention in a channel is automatically shared with its members, and access follows people as they join or leave. You can add anyone by email, even if they don't have a Kuuumba account yet.

6. Put the agent to work

Press c + a to start a chat with an agent that has access to your entire workspace. Ask "what's the latest on the launch?" and it answers from your team's recent emails, messages, tasks, docs, and call transcripts. In any channel, mention @Kuuumba to pull an agent into the conversation.

You can also set up automations: scheduled agent runs, like a daily to-do summary, are delivered to your inbox.

7. Connect your tools

• GitHub: Link your account in Settings under Account. Tasks will move through "In Progress," "In Review," and "Done" as you branch, open PRs, and merge. See GitHub integration.
• MCP connectors: connect Notion, Slack, and other tools under Settings → Connectors so agents can reach them. .
• Your coding agents: point Claude Code, Codex, or any MCP client at your Kuuumba workspace. See MCP setup.

Next steps