← All examples

Gmail Tool

MCP tool that sends emails, searches inbox, and manages Gmail using OAuth. Connect Google and handle email from any agent.

toolgooglegmailoauthemailmcp
Deploy this example

An MCP tool that connects to Gmail via OAuth. Send emails, search your inbox, and manage messages — all callable by any agent or MCP client.

What's included

  • OAuth connection — connects to Gmail via Reminix managed OAuth
  • Send emails — compose and send messages through Gmail
  • Search inbox — find and list messages by query
  • List/read messages — retrieve and read email content
  • MCP server — discoverable and callable by any agent or MCP client

When to use this

Pick the Gmail Tool example when you want to:

  • Build an agent that sends transactional or notification emails
  • Create a conversational agent that searches and summarizes inbox content
  • Learn how OAuth connections work with Google APIs

How connections work

Reminix handles the Google OAuth flow, token exchange, and automatic refresh. Your tool handler receives a valid access token and uses the Gmail API directly.

  1. Add Google OAuth credentials in the Reminix dashboard
  2. Authorize the connection to your Gmail account
  3. Your tool gets fresh tokens on every call

Project structure

├── tools/
│   ├── send_email.py          # Send an email
│   └── search_inbox.py        # Search inbox by query
├── main.py                    # Entry point with serve()
├── pyproject.toml
└── reminix.config.toml

Quick start

After deploying and connecting your Google account, any agent in your project can send emails and interact with Gmail automatically.