← Back to Documentation

Gmail

Read, search, and send emails with AI assistance. Manage drafts, organize with labels, and handle attachments.

Setup

Connect the Gmail toolkit to your Google account to allow your AI assistant to read, search, and send emails on your behalf.

Prerequisites

Before connecting Gmail, ensure you have configured an MCP server in your toolforest.io dashboard.

Setup Steps

Step 1: Connect to Google

1. Navigate to your MCP server panel in the toolforest.io dashboard
2. Locate the Gmail toolkit
3. Click Connect
4. You’ll be redirected to Google’s authorization page

Important: The Google account you connect doesn’t need to match your toolforest.io email address.

Step 2: Authorize Permissions

Google will ask you to grant toolforest.io the following permissions:

• View your email messages and settings – Allows toolforest.io to read messages, threads, labels, and mailbox metadata
• See, edit, create, or change your email settings and filters in Gmail – Allows toolforest.io to manage labels and filters
• Manage drafts and send emails – Allows toolforest.io to create drafts and send messages on your behalf
• Read, compose, and send emails from your Gmail account – Allows toolforest.io to compose replies, forwards, and new emails

Check each box, then click Continue to grant these permissions.

Step 3: Confirmation

After authorizing, you’ll be redirected back to toolforest.io with a “Successful connection” message. The toolkit status will now show Connected.

Understanding Permissions

What toolforest.io Can Access

toolforest.io’s permissions allow your AI assistant to:

• Read mail: Search messages, view threads, and download attachments
• Compose and send: Create new emails, reply, reply-all, and forward
• Manage drafts: Create, list, update, and send drafts
• Organize: Apply labels, mark read/unread, archive, star, or trash messages, and manage filters

Data Privacy

Your email data is retrieved only when you explicitly ask your LLM to query it. toolforest.io does not store your messages permanently; it acts as a bridge to fetch the specific information your assistant needs to answer your questions.

Managing Your Connection

Disconnect

To disconnect the toolkit:

1. Click the Disconnect button in your MCP server panel
2. toolforest.io will remove all stored access tokens

Revoke Permissions

To fully revoke toolforest.io’s access to your Google account:

• Visit your Google Account permissions page
• Find toolforest.io and click Remove Access

Capabilities