> For the complete documentation index, see [llms.txt](https://docs.natoma.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.natoma.ai/apps/gmail.md).

# Gmail (Natoma)

{% hint style="warning" %}
**Early Access** — This server is currently in early access. Features and configuration may change.
{% endhint %}

**Type:** Natoma Hosted

**Source Type:** Remote URL

**Description:** This connection enables you to connect AI to your Gmail to read, search, draft, send, and organize emails. Available tools are a subset of the Google Workspace Server.

***

## Setup

### Step 1: Enable the Gmail API

1. Go to the [Google Cloud Console](https://console.cloud.google.com/).
2. Make sure your target project is selected in the top project dropdown.
3. In the left sidebar, navigate to **APIs & Services > Library**.
4. Search for **Gmail API** and click on it.
5. Click **Enable**.

### Step 2: Configure the OAuth Consent Screen

1. In the Google Cloud Console, go to **Google Auth Platform > Branding** (or search "OAuth consent screen" in the top search bar).
2. If the Auth Platform isn't set up yet, click **Get Started** and fill in the following:
   * **App name:** Gmail MCP Server
   * **User support email:** your email address — click **Next**
   * **Audience:** Select **Internal** if your account is part of a Google Workspace organization — click **Next**
   * **Contact email:** your email address — click **Next**
3. Agree to the Google API Services User Data Policy, then click **Continue > Create**.
4. Click **Data Access** in the left menu, then click **Add or Remove Scopes**.
5. In the panel that appears, scroll down to **Manually add scopes** and paste in both scopes (one per line):

   ```
   https://www.googleapis.com/auth/gmail.readonly
   https://www.googleapis.com/auth/gmail.compose
   ```
6. Click **Add to Table**, then **Update**, then **Save**.

### Step 3: Create an OAuth 2.0 Client ID

1. Go to **Google Auth Platform > Clients > Create Client** and select **Web application** as the application type.
2. Name the application.
3. In the **Authorized redirect URIs** section, click **+ Add URI** and enter:

{% hint style="warning" %}
Use exactly this redirect URI — Natoma will not complete the OAuth flow if it doesn't match.
{% endhint %}

```
https://api.natoma.app/mcp/server/callback
```

4. Click **Create** and copy the **Client ID** and **Client Secret**.

### Step 4: Configure the Connector in Natoma

1. Log in to your Natoma workspace as an Admin and navigate to **Apps**, then search for **Gmail (Natoma)**.
2. Click **+** > **Allow Personal Connections**.
3. In the connector configuration dialog, enter the following:

| Field               | Value                                |
| ------------------- | ------------------------------------ |
| Server name         | Gmail MCP (or any descriptive label) |
| OAuth Client ID     | The Client ID from Step 3            |
| OAuth Client Secret | The Client Secret from Step 3        |

4. Save the connector. Natoma will initiate an OAuth consent flow.
5. Click **Test Connection** to reveal all available tools.