# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.natoma.ai/apps/gmail.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.