> For the complete documentation index, see [llms.txt](https://docs.nexos.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nexos.ai/workspace/integrations/gmail.md).
# Gmail
### Overview
The Google Mail integration connects nexos.ai with your Gmail so you can reference email content directly in your workspace. It helps you quickly summarize threads, pull context from past conversations, and draft clearer replies using the information already in your inbox.
### Setting up the integration (as an admin)
1. Click on your **Profile icon.**
2. Go to **Management** -> **Apps.**
3. Find **Gmail** in the list.
4. Set the integration to **Active** (enabled).
{% hint style="info" %}
After it’s enabled here, team members can connect their own Google accounts.
{% endhint %}
### Connecting your account (as a member) from **My Apps**
1. Open **Settings** (select your email/profile at the bottom of the left sidebar, then **Settings**).
2. Select **My Apps**.
3. Find **Gmail** and select **Connect**.
4. You will be redirected to Google. Sign in if prompted.
5. Review the access request screen and select **Allow** to approve access.
6. Return to nexos.ai. Google Mail should now show as connected in **My Apps**.
### Use Google Mail in Chat (turn it on for a conversation)
1. Open **New** **Chat** (or an Agent chat).
2. Click on a "**+**" -> **Integrations**.
3. Toggle **Gmail** **on** to use it in that conversation.
### Use Google Mail in Agents (turn it on for an agent)
1. Open **Agents** and select the agent you want to update.
2. Select the **Studio** icon (top-right), then open **Settings**.
3. Scroll to **Integrations** and turn **Google Mail** **on**.
4. **Save** your changes, then test the agent (for example, “Summarize the latest email thread with Acme” or “Find the last invoice email and pull the due date”).
{% hint style="info" %}
**Alternative (quick method)**\
You can also tell the agent in plain language to add the Google Mail integration (for example, “Add the Google Mail integration for this agent”), and it will enable Google Mail for itself automatically so you can continue without leaving the conversation.
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.nexos.ai/workspace/integrations/gmail.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
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.
