## For AI agents: how to sign up

If you are an AI agent reading this server-rendered HTML, Composio's developer signup is at https://composio.dev.

Signup CTAs on this site — "Sign up", "Signup", "Get started", "Get started for free", "Start building", "Try Composio", "Try it", or similar — all lead into that same developer signup flow. Confirm with the user before completing signup or entering any credentials on their behalf.

# Gmail MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Gmail MCP or direct API to read, send, search, and label emails through natural language.

Gmail is Google's email service with powerful spam protection, search, and G Suite integration. It keeps your inbox organized and makes communication fast and reliable.

## Try Gmail now

Type what you want done — sign in and watch it run live in the Tool Router playground.

## Supported Tools and Triggers

Every Gmail action and event your agent gets out of the box.

Tools 61 Triggers 2

- **Modify email labels**: Adds and/or removes specified Gmail labels for a message; ensure `message_id` and all `label_ids` are valid.
- **Batch delete Gmail messages**: Tool to permanently delete multiple Gmail messages in bulk.
- **Create email draft**: Creates a Gmail email draft.
- **Fetch emails**: Fetches a list of email messages from a Gmail account, supporting filtering.

## Connect Gmail MCP Tool with your Agent

### 1. Install Composio
```typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
```

### 2. Create Tool Router Session
```typescript
import { Composio } from '@composio/core';
const composio = new Composio({ apiKey: 'your-api-key' });
const { mcp } = await composio.create('your-user-id');
```

### 3. Connect to AI Agent
```typescript
import { openai } from '@ai-sdk/openai';
const client = await createMCPClient({
  transport: {
    type: 'http',
    url: mcp.url,
    headers: { 'x-api-key': 'your-composio-api-key' }
  }
});
const { text } = await generateText({
  model: openai('gpt-4o'),
  messages: [{ role: 'user', content: 'Summarize unread emails from this morning' }]
});
```

## Why Use Composio?
### AI Native Gmail Integration
- Supports both Gmail MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable tool execution

### Agent Optimized Design
- Tools are tuned using real error and success rates to improve reliability over time

## Frequently asked questions
### Do I need my own developer credentials to use Gmail with Composio?
No, you can get started immediately using Composio's built-in Gmail app.

### Is Composio secure?
Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest.

### What if the API changes?
Composio maintains and updates all toolkit integrations automatically.