← Back to all guides

Email & Calendar — Gmail, Outlook & Google Calendar

Langoedge Team4 min read

Giving an Agent an Inbox and a Calendar

Langoedge agents can work directly inside Google Workspace (Gmail, Google Calendar) and Microsoft 365 (Outlook mail and calendar) — searching messages, drafting and sending correspondence, checking free/busy time, and booking meetings.

These apps are reached through an MCP Connector, not through built-in tools.

Earlier versions of this page listed individually named tools such as `find_in_gmail`, `send_outlook_email`, and `get_outlook_calendar_schedule`. Those were hand-written wrappers that no longer exist. The connector now discovers each app's tools live from the provider, so this page describes capabilities rather than fixed tool names — the authoritative list is whatever your connector shows once the account is linked.

Prerequisite — an active account connection. Connect the Google Workspace or Microsoft 365 account on the Connect page before your agent can touch mail or calendar. Without it, the connector cannot list any tools and any step relying on it will fail at run time.

Setting It Up

1

Connect the account

On the **Connect** page, search for Gmail, Google Calendar, or Microsoft Outlook and click **Connect Account**. You authorise directly with Google or Microsoft over OAuth 2.0; Langoedge never sees your password.
2

Add an MCP Connector

On a Text Graph canvas, add an **MCP Connector** node and select the app. It loads that app's full live tool catalogue.
3

Scope it — this one matters

The connector exposes every tool the app offers by default, and for an inbox that includes destructive ones. Turn off delete operations, and consider withholding "send" so the agent can only draft. Then attach the connector to your step's tool list.

What These Apps Let an Agent Do

Exact tool names come from the provider, but the capabilities are stable:

Email (Gmail / Outlook)

  • Search the inbox — find messages by sender, subject, content, or the provider's own query syntax.
  • Draft — compose a message and leave it in Drafts for a human to review and send.
  • Send — dispatch immediately.
  • Manage labels and folders — organise threads into categories.
  • Handle attachments — read and download files attached to a message.
  • Delete — remove messages. Withhold this one unless you have a specific reason not to.

Calendar (Google Calendar / Outlook)

  • Check availability — read free/busy across a date range so the agent can offer real open slots.
  • Create events — schedule a meeting and invite attendees.
  • Read and update events — inspect or amend existing bookings.

Human-in-the-Loop Email

The single most useful pattern here: expose the draft tool and withhold the send tool. The agent composes; a person reviews and sends. This is a configuration-level guarantee rather than a prompt-level request, so no amount of unusual conversation can talk the agent into emailing a customer something you haven't seen.

For workflows where sending automatically is genuinely wanted, pair it with a Quality Gate — a conditional edge that routes the drafted message past a supervisor LLM (or a human approval step) before the send tool is reachable.

Security

All email and calendar integrations authorise over OAuth 2.0. Credentials are held by the connect layer and referenced by an opaque account id — Langoedge stores the link, not your password, and the LLM never sees a token. Access is scoped to the graph owner's connected accounts, so a published graph sends mail as its owner, not as whoever triggered it.

That last point is worth pausing on before you embed an email-capable agent on a public page: every message it sends comes from **your** mailbox.

Frequently Asked Questions

Why don't I see find_in_gmail in my tool list?
Because it no longer exists. Gmail is reached through an MCP Connector, whose tool names come from the provider at run time. Add the connector, pick Gmail, and the node will show you the current list.
Can the agent send emails automatically?
Yes, if you expose a send tool. For human-in-the-loop review, expose only the draft tool and withhold send — the agent then physically cannot dispatch mail.
How does the agent know my calendar availability?
Connect Google Calendar or Outlook and expose its free/busy tool. The agent reads blocked time across a range and offers the gaps.
Can a Voice Graph send email during a call?
Not directly — MCP connectors are Text Graph only. Put the connector on a Text Graph and mount that graph as a tool on your voice node. Run it asynchronously so the caller isn't left waiting while the mail goes out.
Whose mailbox does it send from?
The graph owner's. Connections are per-user, and a graph always acts as its owner regardless of who triggers it.
LT

Langoedge Team

The Langoedge engineering team builds AI agent infrastructure that empowers businesses to deploy reliable, observable AI staff. Follow Langoedge Team on LinkedIn for product updates and architectural deep dives.