---
title: "Gmail connector for agents — authorization and setup — AgentSky"
description: "Gmail offers private and secure email by Google at no cost, for business and consumer accounts. Connect Gmail to AgentSky with managed OAuth."
url: https://agentsky.dev/connectors/gmail
---

# Gmail

Gmail offers private and secure email by Google at no cost, for business and consumer accounts. Connect your account through managed OAuth to use the available operations in an agent task.

[Repo](https://agentsky.dev/auth/start?returnTo=%2Fconnectors%2Fgmail%3Fresume%3D1)

Connect Gmail using the Connectors control before sending. Authorization opens separately and your draft stays here.

Setup

## Connect Gmail with an explicit scope.

You need an AgentSky account and authority to connect the application account. Start with a read-only task before allowing changes.

01

### Find the application

Open connector settings and search for Gmail. If the catalog is unavailable, retry its load; an unavailable list is not proof the app is unsupported.

02

### Review authorization

Review the Gmail account, workspace and permissions on the authorization screen. Your organization's policies or administrator approval may limit which resources the connection can access.

03

### Verify a bounded task

Name one Gmail resource you can already access and ask the agent to check whether a read operation is available. If it is, retrieve and summarize that resource without changing it. If it is not, ask the agent to explain the missing operation or permission.

Verify access and results

## A connected account is the start of the workflow.

Open the same resource in Gmail and compare it with the agent's result. Check the account, resource identifier and current content before using the output for another task.

- Access troubleshooting If Gmail access fails, check the connected identity, resource sharing and requested permissions. Reconnect an expired or revoked account in connector settings. If the connection is healthy but an operation is unavailable, changing accounts may not resolve it.
- Available actions The runtime discovers the connector's current operations and input requirements. Do not assume every feature in the application's website is available as an agent action.
- Authorize changes explicitly For writes, specify the target and the allowed change. An instruction to draft or analyze is not permission to publish, send or delete.

## Gmail connector questions

## Related resources

[Claude Code + GmailUse Gmail with Claude Code in the shared Composer.](https://agentsky.dev/agents/claude-code/connectors/gmail) [Codex + GmailUse Gmail with Codex in the shared Composer.](https://agentsky.dev/agents/codex/connectors/gmail) [OpenClaw + GmailUse Gmail with OpenClaw in the shared Composer.](https://agentsky.dev/agents/openclaw/connectors/gmail) [OpenCode + GmailUse Gmail with OpenCode in the shared Composer.](https://agentsky.dev/agents/opencode/connectors/gmail) [Hermes + GmailUse Gmail with Hermes in the shared Composer.](https://agentsky.dev/agents/hermes/connectors/gmail) [Kimi Code + GmailUse Gmail with Kimi Code in the shared Composer.](https://agentsky.dev/agents/kimi-code/connectors/gmail) [DeepSeek Harness + GmailUse Gmail with DeepSeek Harness in the shared Composer.](https://agentsky.dev/agents/dsh/connectors/gmail) [pi + GmailUse Gmail with pi in the shared Composer.](https://agentsky.dev/agents/pi/connectors/gmail) [All connectorsUnderstand managed application access.](https://agentsky.dev/connectors) [ChannelsChoose where the agent conversation happens.](https://agentsky.dev/channels) [PricingReview charges before running work.](https://agentsky.dev/pricing)

## Connect the right Gmail account.

[Open connector settings](https://agentsky.dev/connectors)

## Frequently asked questions

### How do I connect Gmail to AgentSky?

Sign in to AgentSky, open Connectors in the Composer and search for Gmail. Choose Connect, complete the provider's authorization flow, and return to your draft. Check that the intended account appears as connected before sending.

### Do I need a Gmail API key?

This listing uses managed OAuth. Authorize the account in the provider's flow; do not paste a password or API key into the Composer. Any account, plan or administrator requirements are determined by Gmail.

### What can my agent do in Gmail?

The runtime discovers current operations and their required inputs. A catalog listing does not promise every feature of Gmail. Start by asking which operation supports your task, and specify the resources and changes you authorize.

### Does connecting Gmail make agent tasks free?

No. Account authorization and task usage are separate. AgentSky bills compute and model usage according to its pricing. Any Gmail subscription, API quota or provider charge remains separate; review those limits before running a task.

---

Markdown copy of https://agentsky.dev/connectors/gmail. Every agentsky.dev page has one: add `.md` to its address or send `Accept: text/markdown`. Start from https://agentsky.dev/llms.txt.
