Docs
Home

Connecting Gmail

Connect Gmail so your agents can read and draft email on your behalf.

Connect Gmail and your agents can read your mail and draft replies for you — without ever handling your password. You connect once with your own Google sign-in, and agents use that access only when they act on your behalf.

Gmail connects through Google's official Gmail service, so your agents can read your mail and compose drafts and messages — and nothing else.

Setting it up

There are two ways to set Gmail up. A workspace admin can enable it once for everyone, or you can connect it just for yourself as a private server.

Admin (for the whole workspace):

  1. Open Settings → Agents → MCP Servers and scroll to Connectors.
  2. Find Gmail and choose Set up for workspace.
  3. In the Google Cloud console, create an OAuth 2.0 client of type Web application, register the callback URL shown in the form, then paste the Client ID and Client Secret and choose Enable.

Once an admin has enabled Gmail, every member sees it ready to connect.

Just for you (a personal server):

  1. Open Settings → Account → My MCP servers and scroll to Connectors.
  2. Find Gmail and choose Connect as a personal server.
  3. Create an OAuth 2.0 client (type Web application) in the Google Cloud console, register the callback URL shown, paste the Client ID and Client Secret, and choose Add & connect.

This adds Gmail to your private My MCP servers and connects it as you — no admin needed.

Connecting

If an admin already set Gmail up:

  1. Open Settings → MCP Preferences (or the Connectors section on the MCP Servers page).
  2. Find Gmail and click Connect.
  3. Sign in with Google and approve the requested access. You'll be returned to Monad with a green Connected badge.

From then on you can ask an agent things like "summarize my unread email" or "draft a reply to the last message from Sam" without thinking about credentials.

What your agents can do

Your agents act as your account, but only to read mail and compose drafts and messages. They can't delete mail, change your settings, or touch anything outside Gmail.

Reconnecting

If you see an amber Reconnect needed badge, your access expired or the permissions changed. Click Reconnect and approve again.

Disconnecting

Click Disconnect at any time and Monad immediately stops using your Gmail account. Your connection is yours alone — other members can't use it, and admins can see only that you've connected, never your mail or your tokens.