Gumball

Gumball is the personal agent that comes with every Gumloop account. Unlike custom agents, which you build and share with your team, Gumball belongs to you: it is created automatically the first time you open it, it can search every skill you can access — including your teams’ skills — and it uses your own connectors to read and act in the apps you’ve connected.

On top of chat, Gumball runs three proactive features that work while you’re away:

Daily Chew

A short report from your connected apps, delivered on your schedule.

Smart Inbox

Labels new email as it arrives in Gmail or Outlook, moves the noise out of your Inbox, and can draft replies for you.

Meeting Prep

A context brief before each meeting on your calendar.

All three are owner-only. Gumball is a personal agent, so only you can configure or view its Smart Inbox, Daily Chew, and Meeting Prep — they can’t be shared like a custom agent.

What Gumball Comes With

The right-hand rail on the Gumball home screen is the control panel for everything below.

Section	What it does
Email	Gumball’s own address, `gumball@gumloopagents.com`. Email it like a coworker and it replies.
Inbox	Connect a Gmail or Outlook mailbox for Smart Inbox.
Calendar	Connect a Google Calendar or Outlook Calendar account for Meeting Prep.
Slack	Opens your DM with the Gumloop Slack app, where you can chat with Gumball. See Gumball in Slack.
Connectors	Every app Gumball can read and act in.
Triggers	Schedules and event triggers that run Gumball automatically.
Personalization	The Tone and Design skills Gumball curates about how you like to be written to and how you like output laid out.

Below the chat box are tabs for Daily Chew, Smart Inbox, Tasks, and Artifacts — the reports Gumball has produced, the Situations it has surfaced, and the files it has created.

Emailing Gumball

Gumball’s email address is reserved and fixed — you can’t rename it or hand it to another agent. Send it a request and it replies in the same thread using your connectors.

Gmail thread where a user emails gumball and Gumball replies with a summary of assigned Linear tickets

Gumball follows the same rules as any agent email inbox — including DKIM checks on the sending domain.

Gumball in Slack

You can talk to Gumball by direct messaging the Gumloop Slack app in your workspace. There is nothing to set up and no channel to create — find the Gumloop app in your Slack sidebar (or under Apps) and send it a message.

Slack DM with the Gumloop app where a user asks to fetch their latest emails and Gumball replies with progress

The Slack row in the right rail links straight to that DM once you have connected a Slack account; click Open.

	How it works in a DM
Which agent answers	Always your own Gumball. Custom agents live in channels — DMs never reach them.
Who you are	Gumball matches your Slack email to your Gumloop account, and runs on your connectors and skills, exactly like the web app. Without a matching Gumloop account you get a sign-up prompt instead.
Conversations	Each top-level message you send starts a new conversation; reply in that message’s thread to continue it.
Everything else	Same Gumball — your skills, connectors, artifacts, and history are shared with the web app, and thread commands like `!stop` and `!link` work.

Gumball DMs use your workspace’s existing Gumloop Slack app. If it was installed before DMs were supported, Gumball replies asking a workspace admin to reconnect the Gumloop Slack app — reconnecting it from the Connectors page grants the extra direct-message permissions and nothing else changes.

Want a DM with a custom agent and its own name and avatar? Use a Custom Slack App.

Daily Chew

The Daily Chew is a short report about what happened across your connected apps, on the schedule you pick.

Configuring It

Daily Chew settings with Time, Days, Connectors, Instructions, Model, and Delivery toggles

Setting	Notes
Time and Days	When the report runs, in your timezone. Both are required the first time you set it up.
Connectors	All connectors uses everything you have connected at run time. Selected connectors pins a specific list (up to 50).
Instructions	What you want emphasised, up to 4,000 characters.
Model	Defaults to Gumball’s model.
Delivery	Reports always appear in Gumball. Email and Slack DM are optional extras.

Leave All connectors selected if you keep adding tools — the report picks up new connectors automatically instead of needing to be re-configured.

What a Report Looks Like

Each report has a one-glance summary (two sentences, 40 words max) plus a full document made of up to four sections, in this order — sections with nothing to say are left out entirely: ## Catch-up · ## Priorities · ## Schedule · ## Next steps Facts in the document are attributed back to the app they came from. Routine calendar entries stay in the document rather than the summary, since your schedule is already on screen next to it.

How It Behaves

Runs are read-only. The Daily Chew can only use tools that read; anything that could write, send, or change something is blocked, including tools reached through another tool.
Sources fail independently. If Slack is down, the rest of the report still gets written and Slack is simply marked as failed for that run.
A failed source doesn’t lose your place. Gumball only advances its “last read” marker for sources that actually succeeded, so the next run picks up what it missed.
First run looks back 16 hours. After that, each run covers everything since the previous successful one.
Reports are never sent twice. If a run is retried internally, you get one report, not two.
Pausing stops it from running; resuming puts it back on schedule. Past reports stay in your history either way.

Situations

Daily Chew “things to know” are first-class Situations, surfaced on the Gumball home screen in Highlights. Highlights shows the current morning’s open Situations plus earlier Situations you haven’t dismissed. Each Situation is one concern with a title, summary, and sources or citations. It can also include zero or more ordered nested steps. Open a Situation card to see its detail sheet and its nested list under Plan. For each step, you can:

Edit the prompt before sending. The editor includes the hint “Use @ to mention agents and skills in the prompt.”
Change its status to To do, Done, or Skipped.
Accept or dismiss the step.

Editing a step only saves the edited prompt and any changed @mentions; it does not start a chat. Accepting an individual step can start a chat for that step. Send to Gumball sends the whole Situation as one plan: all steps run in order in a single chat, not one chat per step. Your edited prompt and @mentions are used when the chat starts. Sending the same Situation again returns the existing chat instead of creating a second one. Completed Situations and steps show View chat. A Situation with no steps cannot be sent as a plan. At the Situation level, you can choose Dismiss. A Situation with no nested steps also shows Mark handled. You can dismiss anything you can see. Citations can appear on the Situation itself and on individual steps where available. Situations are deliberately narrow: they represent real work you own with a concrete outcome Gumball could take on. A mention in a channel does not qualify on its own; a customer waiting on a document you promised does.

Smart Inbox

Smart Inbox labels new email as it lands in your mailbox, using labels you define in plain English. It’s not a separate inbox — everything happens as native tags in your real mailbox (Gmail labels, Outlook categories), so it works in the Gmail or Outlook app, on mobile, and in any client you already use.

Smart Inbox supports Gmail and Microsoft Outlook, and requires a Pro plan or above. Gumball watches one mailbox at a time — connecting a second one replaces the first.

Smart Inbox labels and categorizes mail, then makes one drafting decision for each message. It can create native drafts in Gmail or Outlook, but it does not create suggested actions or reply suggestions in Gumball.

Turning It On

Open the Smart Inbox tab

From the Gumball home screen, open the Smart Inbox tab and click Enable Smart Inbox.

Smart Inbox tab showing the Connect your inbox empty state with an Enable Smart Inbox button

Pick the mailbox

Choose the connected Gmail or Outlook account Gumball should watch, then confirm.

Connect your inbox dialog with a mailbox account selector and an Enable Smart Inbox button

Gumball seeds five built-in labels and starts classifying the next email that arrives.

Enabling requires permission to read email and modify messages — on Gmail it also needs to list and create labels. Two capabilities are optional, and if your organization’s app rules block them, labeling keeps working without them: creating drafts (no draft is created) and, on Outlook, archiving (labels still apply, but mail stays in your Inbox).

Gmail vs. Outlook

Both mailboxes get the same classification, labels, and reply drafts. Three things behave differently because the providers themselves do.

	Gmail	Outlook
Native tag	A Gmail label.	An Outlook category, registered so it shows up in the Categorize menu with its colour.
Renaming a label	The Gmail label is renamed too, so mail you already have follows the new name.	Outlook can’t rename a category, so the new name applies to future mail only and older mail keeps the old category.
Moving mail out of the Inbox	Always available.	Needs the archive permission. Without it, labels apply and mail stays in your Inbox.

Labels

You start with five built-in labels, and you can add your own up to a total of 25.

Built-in label	Applied when
Needs reply	You should reply.
Time sensitive	There’s an explicit deadline or urgency.
Waiting on you	Progress requires your action.
FYI	Useful information, no action needed.
Low priority	Non-urgent, limited immediate value.

A label is just a name, a definition, and a colour. The definition is the instruction Gumball classifies against — write it the way you’d explain it to a new assistant.

New label form with Name, Definition, and a colour picker

Keep In Inbox vs. Move Out

Every label sits in one of two groups, and the group decides where matching mail ends up.

Labels card with a Move these out of my Inbox column and a Keep these in my Inbox column

Keep wins. A message leaves your Inbox only when every label Gumball applied to it is in the “Move these out” group. One “Keep” label anywhere on the message keeps it in your Inbox.

The Existing labels toggle in Manage controls whether Gumball skips mail you’ve already organised: when it’s on, any message that already carries one of your own labels or categories is left alone. Labels Gumball manages don’t count for this.

Labels management panel showing the Existing labels toggle and the two label groups

A message can receive at most 5 labels. Labels Gumball isn’t confident about are dropped rather than guessed.

Classification Happens Once

Gumball classifies each email as it arrives, and never re-runs on old mail.

Editing a label’s definition, colour, or group changes future email only.
Turning a label off stops it being applied going forward; mail already labelled keeps its label.
Deleting a custom label removes it from Gumball; the native label or category stays on the messages that already have it.
Renaming a label renames the matching Gmail label, so your existing mail follows the new name. On Outlook the new name is used going forward and older mail keeps the old category.
The five built-in labels can be disabled or edited, but not deleted.
A label that shares a name with one of your own labels or categories is adopted rather than duplicated, and Gumball starts managing it.

Reply Drafts

When Gumball decides a message needs a reply, it can write one straight into your mailbox as a native draft — so you open Gmail or Outlook, read it, edit it, and hit send.

Smart Inbox settings with Inbox account, Classification model, Drafting instructions, and Draft replies options

Setting	What it controls
Inbox account	Which Gmail or Outlook mailbox Smart Inbox watches.
Classification model	The model used to label email. Defaults to Gumball’s own model.
Drafting instructions	Standing instructions applied to every reply Gumball drafts. These outrank your Tone personalization.
Draft replies	Whether a native draft is created in your mailbox at all.

Draft replies is an on/off choice, not a scale:

Option	What happens
When confident (default)	Gumball writes a native draft when it decides the message needs a reply and it is confident in the reply it produced. Otherwise, no draft is created.
Off	No drafts are created in your mailbox. Gumball skips reply generation altogether, so it doesn’t cost you credits.

Drafts are written from the thread itself plus up to three of your past replies to that sender, so they sound like you. Smart Inbox drafts when a message asks you for an explicit action or involves a commitment, decision, or deadline. Mentions, FYIs, and notifications alone are not enough. If Smart Inbox decides not to draft, drafting is off or blocked, or it skips a thread whose previous draft you edited, nothing is created. Labeling still happens, and you can always ask Gumball for a reply in chat.

If you configured this back when it offered several confidence levels, it now reads as When confident. Only an explicit Off is carried over.

Gumball never overwrites a draft you’ve touched. If a newer message arrives in a thread where you edited Gumball’s draft, it skips drafting entirely rather than replacing your text.

Gumball only ever creates drafts. Smart Inbox cannot send email on your behalf.

Disconnecting

Turning Smart Inbox off, or switching to a different mailbox, clears Gumball’s record of what it labelled and its link to the native labels or categories. Those stay in your mailbox on the mail that already has them, and Gumball re-adopts them by name if you reconnect.

Meeting Prep

Meeting Prep gives you a brief before a meeting starts: who’s attending, what you’ve discussed with them before, what’s still open, and what to raise.

Turning It On

Connect a calendar

Pick the Google Calendar or Outlook Calendar account Gumball should watch, then click Enable Meeting Prep.

Prep every meeting dialog with a calendar account selector and an Enable Meeting Prep button

Choose what gets prepped

Meeting Prep settings with calendar account, automatic prep toggle, trigger mode, minutes before event, meeting scope, connectors, instructions, model, and delivery

Setting	Notes
Prep meetings automatically	When off, meetings still appear and you prep them one at a time with Prepare now.
Calendar account	The connected Google Calendar or Outlook Calendar account.
Calendar	Which calendar on that account to watch.
Minutes Before Event	How far ahead of the meeting the brief is written.
Meetings to prep	All meetings, or External meetings only.
Connectors	All connected apps, or a specific list.
Instructions	What research you want done and how you want it framed.
Delivery	In Gumball always; Email and Slack DM optional.

External meetings only is the default. A meeting counts as external when at least one guest — other than you — has an email domain different from yours. Solo events and all-internal meetings are skipped.

Prepping a Meeting Yourself

Upcoming meetings are listed on the Gumball home screen whether or not automatic prep is on.

Upcoming meetings list on the Gumball home screen

Open one and click Prepare now to generate a brief on demand.

Meeting detail dialog showing time, location, guests, and Join meeting and Prepare now buttons

Prepare now works even when automatic prep is turned off — turning it off just means Gumball won’t fire on its own.

What a Brief Looks Like

A short summary (two to three sentences, 60 words max) plus a document with up to four sections, in this order, omitting any that are empty: ## Attendees · ## Prior context · ## Open questions · ## Talking points Prior context opens with a recap of your history with these people, then the relevant threads, decisions, and risks across every connected app — email, Slack, meeting notes, CRM activity — woven together rather than listed per tool. The meeting’s time, location, and guest list aren’t restated, since they’re already on the card next to the brief. Meeting Prep runs are read-only and handle source failures exactly like the Daily Chew.

Google Calendar and Outlook Calendar behave the same way here: same settings, same automatic and Prepare now paths, and the same brief.

Availability and Permissions

Feature	Requirement
Gumball chat	Included with every account. Gated by the `access_general_agent` organization permission.
Smart Inbox	Pro plan or above, plus a connected Gmail or Outlook mailbox.
Daily Chew	Any plan, with at least one connector.
Meeting Prep	Any plan, with a connected Google Calendar or Outlook Calendar account.

Organization admins control access through user roles. Smart Inbox, Daily Chew, and Meeting Prep each have their own permission that cascades from Gumball access — turning off Gumball access for a role turns off all three.

For custom roles, Smart Inbox, Daily Chew, and Meeting Prep are restricted by default. An admin has to grant them explicitly.

If your access is removed while Smart Inbox is running, Gumball turns it off. If the restriction is later lifted, you need to re-enable it yourself — it doesn’t resume on its own.

FAQ

What's the difference between Gumball and a custom agent?

Gumball is personal and automatic — one per user, created for you, and it searches every skill you can access, including your teams’ skills, instead of using a fixed list of attached skills. Custom agents are built by you, shared with your team, and only see the skills, tools, and instructions you configure on them. Gumball is also the only agent with Smart Inbox, Daily Chew, and Meeting Prep.

How do I chat with Gumball in Slack?

DM the Gumloop app in your Slack workspace — find it in your sidebar or under Apps and start typing. No setup, no channel, no @mention. The Slack row on the Gumball home screen opens that DM for you.

Can I DM a custom agent instead of Gumball?

Not through the standard Gumloop app — DMs there always go to your own Gumball, and custom agents are added to channels. To DM a custom agent, connect a Custom Slack App for it.

Gumball says it needs updated Slack permissions. What now?

Your workspace’s Gumloop Slack app was installed before DM support and is missing the direct-message permissions. A workspace admin needs to reconnect the Gumloop Slack app from the Connectors page. Channel agents keep working in the meantime.

Can I change Gumball's email address?

No. gumball@gumloopagents.com is reserved for the personal agent and can’t be renamed, disabled, or claimed by a custom agent.

Can the Daily Chew or Meeting Prep change something in my apps?

No. Both run read-only. Only tools that read data are available during a run — anything that writes, sends, or modifies is blocked, including write tools reached indirectly through another tool.

One of my apps was down during a run. Do I lose that day's updates?

No. Each source is tracked separately, and Gumball only advances its position for the sources that succeeded. The failed source is reported as failed for that run and its missed items show up in the next one.

What does the Daily Chew cover on its very first run?

The previous 16 hours. Every run after that covers everything since the last successful run.

I left the connector list empty. What gets included?

Everything you have connected at the time the report runs. That’s the same as choosing All connectors — and it means newly connected apps are picked up automatically.

Does Smart Inbox work with Outlook?

Yes. Connect either a Gmail or an Outlook mailbox. On Outlook your labels become Outlook categories instead of Gmail labels, and the only behavioural differences are that categories can’t be renamed on existing mail and that moving mail out of your Inbox needs the archive permission. Gumball watches one mailbox at a time, so connecting Outlook replaces a connected Gmail account.

Will Smart Inbox label the email that's already sitting in my inbox?

No. Classification happens as email arrives, so only mail received after you enable it gets labelled. The same applies to changes: editing or adding a label affects future email, never mail that’s already been classified.

I renamed a label — what happens to email that already had it?

On Gmail the rename is applied to the label itself, so existing mail keeps the label under its new name. On Outlook categories can’t be renamed, so the new name is used for future mail and older mail keeps the old category. Definitions, colours, and group changes only affect new mail on either provider.

Why did a message stay in my Inbox even though it got a 'move out' label?

Because another label on the same message was in the “Keep these in my Inbox” group. Keep always wins — a message only leaves your Inbox when every label applied to it says move.

Why didn't Gumball label an email at all?

Most often one of three reasons: the Existing labels toggle is on and you had already labelled or categorised that message yourself; none of your label definitions matched confidently enough; or the message arrived before Smart Inbox was enabled.

Can Smart Inbox send emails for me?

No. It only creates drafts in your mailbox. Sending is always your action.

Why was no draft created?

Draft replies may be set to Off, Gumball may not have been confident or decided the message needed a draft, your organization’s app rules may block draft creation, or you may have edited Gumball’s previous draft in that thread and it declined to overwrite it. Labeling still works, and you can always ask Gumball for a reply in chat.

What happens to my labels if I disconnect my mailbox?

Gumball forgets what it labelled and drops its links to the native labels or categories. Those stay in your mailbox on the mail that already has them, and if you reconnect, Gumball re-adopts the ones with matching names.

Does Meeting Prep work with Outlook Calendar?

Yes. Connect either a Google Calendar or an Outlook Calendar account, pick the calendar to watch, and everything else — automatic prep, Prepare now, meeting scope, and the brief itself — works the same way.

Why didn't Meeting Prep run for a meeting on my calendar?

The most likely reason is External meetings only — a meeting is only external if at least one guest besides you has a different email domain. Also check that automatic prep is on and that the meeting starts further out than your Minutes Before Event setting. You can always use Prepare now.

Can I still prep a meeting with automatic prep switched off?

Yes. Turning it off only stops Gumball firing on its own. Meetings still appear on the home screen and Prepare now works normally.

Do reports get delivered twice if something is retried?

No. Each run has a single delivery boundary, so an internal retry can’t produce a duplicate report.

Where do reports go?

Always into Gumball, where they’re kept in history. Email and Slack DM are optional on top of that. Slack DMs are matched to you by your account email — if there’s no email on your profile, the Slack DM is recorded as not sent and the report is still saved.

Why isn't an important item shown as a Situation?

Situations are deliberately narrow: they need work you own with a concrete outcome Gumball could take on. Notifications, mentions, and general activity aren’t enough on their own.

Does editing a Situation step send it?

No. Editing only saves the prompt and any @mentions you changed. The edited text is used when the step is sent.

Does each Situation step become its own chat?

No. Send to Gumball sends the entire Situation as one plan, with all steps in order in a single chat.

What if I send the same Situation twice?

You get the existing chat back instead of a second chat.

Why can't I send this Situation?

A Situation with no nested steps cannot be sent as a plan. Use Mark handled or Dismiss instead.

Do these features cost credits?

Yes. Classifying email, drafting replies, and generating reports use models and tools like any other agent activity. See Credits.

My admin restricted Gumball and then unrestricted it. Why isn't Smart Inbox running?

Smart Inbox is switched off when access is removed and does not resume automatically. Re-enable it from the Smart Inbox tab.

Get Started

Core Concepts

Enterprise Features

Nodes

Common Errors

Daily Chew

Smart Inbox

Meeting Prep