Gmail Connector for AI agents.

30 live capabilities

Manage your professional inbox and automate email replies with your AI client.

Live agent request Gmail / Connector

Waiting for input…

AI Agent

Why people use Gmail

Gmail for Email Inbox Management

With this Connector, your AI client handles the searching for you. You can just ask for the latest update on a project, and it'll pull the relevant info from the threads, summarize it, and give it to you where you're already working.

What Vinkius changes

You get a way to interact with your email using natural language instead of clicking through folders.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

Real-world use case 01

Finding specific files in old threads

An engineer asks their agent to find a specific attachment from a vendor last week.
Real-world use case 02

Clearing high-volume alerts

An ops lead has 50 unread alerts.
Real-world use case 03

Personalized outreach at scale

A marketer needs to email 10 clients.

Complete set · 30capabilities

The complete Gmail capability set.

These are the exact actions your AI can choose when you ask it to work with Gmail.

Capability set01 / 08

01—04

4 capabilities in this set.

Part of 30 available through Gmail.

01 Capability
List unread emails
List your most recent unread messages. This works like searching with the is:unread filter.
02 Capability
List gmail messages
List messages from your inbox using search syntax. Use q to find specific things like has:attachment.
03 Capability
Modify message labels
Add or remove labels from a specific message. You can use system labels like UNREAD or your own custom ones.
04 Capability
Trash gmail message
Move a message to the trash. This is the safe way to clear your inbox since it stays there for 30 days.

Capability set02 / 08

05—08

4 capabilities in this set.

Part of 30 available through Gmail.

05 Capability
Batch modify messages
Update labels on multiple messages at once. This is perfect for mark all as read actions using message IDs.
06 Capability
Batch delete messages
Permanently delete a group of messages. Use this only when you don't need to recover the data.
07 Capability
Get thread details
Read every message in a specific conversation thread. This gives you the full context of a long back-and-forth.
08 Capability
List mailbox labels
List all labels in your account. This helps you identify the IDs you need for organizing mail.

Capability set03 / 08

09—12

4 capabilities in this set.

Part of 30 available through Gmail.

09 Capability
Get label details
Get the details for a specific label. Use this to check the properties of your custom tags.
10 Capability
Create label
Create a new custom label for your mail. This allows you to group messages by project or person.
11 Capability
Delete label
Permanently delete a custom label. Note that system labels like SENT cannot be removed.
12 Capability
List drafts
List all your current email drafts. This shows you the snippets of what you've started writing.

Capability set04 / 08

13—16

4 capabilities in this set.

Part of 30 available through Gmail.

13 Capability
Get draft
Read the full content of a specific draft. Use this to review your work before you hit send.
14 Capability
Update draft
Edit the content of an existing draft. You'll need the draft ID from the list command first.
15 Capability
Send draft
Send an existing draft immediately. This removes the draft from your folder once it's dispatched.
16 Capability
Get attachment
Download an email attachment as base64 data. You first need to find the attachment ID in the message content.

Capability set05 / 08

17—20

4 capabilities in this set.

Part of 30 available through Gmail.

17 Capability
List inbox filters
List the rules that automatically process your incoming mail. See what's currently being forwarded or labeled.
18 Capability
Create inbox filter
Create a new rule to automatically label, star, or forward mail. You provide the criteria and actions as JSON.
19 Capability
List mailbox history
Track changes in your mailbox over time. This is useful for syncing and detecting new updates.
20 Capability
Get gmail profile
Get your mailbox identity and general stats. This is useful for tracking changes via a history ID.

Capability set06 / 08

21—24

4 capabilities in this set.

Part of 30 available through Gmail.

21 Capability
Verify api connection
Check if your Gmail API connection is working. Use this to troubleshoot your setup.
22 Capability
Find emails from sender
Search for emails from a specific address. This is a shortcut for the from: operator.
23 Capability
Get message content
Read the full body of a specific email. This is what you use after finding a message ID.
24 Capability
Untrash gmail message
Move a message from the trash back to your inbox. It's a quick way to recover accidentally deleted mail.

Capability set07 / 08

25—27

3 capabilities in this set.

Part of 30 available through Gmail.

25 Capability
List gmail threads
List conversation threads using standard Gmail search syntax. You can use the q parameter to filter results.
26 Capability
Create draft
Create a new email draft for you to review. It's safer than sending immediately because you can check it first.
27 Capability
Get vacation settings
Check if your vacation auto-responder is currently active. Use this to see your current out-of-office status.

Capability set08 / 08

28—30

3 capabilities in this set.

Part of 30 available through Gmail.

28 Capability
Delete draft
Permanently delete an email draft. Be careful as this action cannot be undone.
29 Capability
Update vacation settings
Toggle your vacation auto-responder on or off. You can set specific dates and recipient restrictions.
30 Capability
Send email
Compose and send an email immediately. This supports plain text, HTML, and standard headers like CC and BCC.

Set up in minutes

One URL. Then ask Gmail to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Gmail from the conversation.

Choose your client

Live preview

Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_wa8i0RmDTsJc5f8Q00AQRFjYSCGVye2I8kvXm00S/mcp

Step 01

Open Connectors

In Claude Web or Claude Desktop, open Settings and choose Connectors.
Step 02

Add the URL

Choose Add custom connector, name it Gmail, and paste the URL above.
Step 03

Turn it on in chat

Select +, open Connectors, and enable Gmail for the conversation.

ChatGPT · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_wa8i0RmDTsJc5f8Q00AQRFjYSCGVye2I8kvXm00S/mcp

Step 01

Open MCP settings

On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
Step 02

Add the URL

Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Gmail URL.
Step 03

Save and start

Save the connection and enable Gmail in your conversation. Desktop may ask you to restart once.

Cursor · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "gmail": {
      "url": "https://edge.vinkius.com/vk_preview_wa8i0RmDTsJc5f8Q00AQRFjYSCGVye2I8kvXm00S/mcp"
    }
  }
}

Step 01

Open MCP Settings

Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
Step 02

Add the server config

Paste the JSON configuration above into the mcp.json file that opens
Step 03

Save the file

Cursor will automatically detect the new Connector
Step 04

Start using Gmail

Open Agent mode in chat and ask: "Using Gmail, help me...". 30 tools available

VS Code Copilot · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "gmail": {
      "url": "https://edge.vinkius.com/vk_preview_wa8i0RmDTsJc5f8Q00AQRFjYSCGVye2I8kvXm00S/mcp"
    }
  }
}

Step 01

Create MCP config

Create a .vscode/mcp.json file in your project root
Step 02

Add the server config

Paste the JSON configuration above
Step 03

Enable Agent mode

Open GitHub Copilot Chat and switch to Agent mode using the dropdown
Step 04

Start using Gmail

Ask Copilot: "Using Gmail, help me...". 30 tools available

Windsurf · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "gmail": {
      "url": "https://edge.vinkius.com/vk_preview_wa8i0RmDTsJc5f8Q00AQRFjYSCGVye2I8kvXm00S/mcp"
    }
  }
}

Step 01

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Step 02

Add the server

Paste the JSON configuration above into mcp_config.json
Step 03

Save and reload

Windsurf will detect the new server automatically
Step 04

Start using Gmail

Open Cascade and ask: "Using Gmail, help me...". 30 tools available

Cline · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "gmail": {
      "url": "https://edge.vinkius.com/vk_preview_wa8i0RmDTsJc5f8Q00AQRFjYSCGVye2I8kvXm00S/mcp"
    }
  }
}

Step 01

Open Cline MCP Settings

Click the Connectors icon in the Cline sidebar panel
Step 02

Add remote server

Click "Add Connector" and paste the configuration above
Step 03

Enable the server

Toggle the server switch to ON
Step 04

Start using Gmail

Ask Cline: "Using Gmail, help me...". 30 tools available

Claude Code · Terminal command

Official guide ↗

Advanced setup

claude mcp add gmail --transport http "https://edge.vinkius.com/vk_preview_wa8i0RmDTsJc5f8Q00AQRFjYSCGVye2I8kvXm00S/mcp"

Step 01

Install Claude Code

Run npm install -g @anthropic-ai/claude-code if not already installed
Step 02

Add the Connector

Run the command above in your terminal
Step 03

Verify the connection

Run claude mcp to list connected servers, or type /mcp inside a session
Step 04

Start using Gmail

Ask Claude: "Using Gmail, show me...". 30 tools are ready

Where the request belongs

Work Gmail can move forward.

Built around the request

This is for the person whose inbox is a source of constant distraction. It's for the pro who needs to find specific information across hundreds of threads without the manual search fatigue.

01

Software Engineer

Checking for production alerts or PR comments without leaving the IDE.

02

PR Specialist

Drafting personalized outreach to multiple stakeholders in seconds.

03

Operations Manager

Parsing through high-volume updates to find specific data points.

When one Connector is not enough

Combine Gmail with the systems that finish the task.

View all recipes

Connectors for eCommerce Order Invoicing

Order placed, invoice generated, payment follow-up tracked , bookkeeping that runs while you sleep

MCP Workflow for Automated Sales Follow-Ups

AI agent reads your CRM, checks Gmail history and sends WhatsApp follow-ups , all in one pass

MCP Workflow for Online Class Scheduling

Assignments posted, Zoom sessions created, students notified , your AI agent runs the classroom logistics

MCP Workflow for Smart Support Ticket Escalation

Your AI agent triages support tickets, deduplicates escalations and logs everything , hands off

MCP Workflow to Triage GitHub Bugs Into Jira

Your AI agent triages bugs across Jira and GitHub, then emails the right person with full context

Track Invoices Automatically Using Connectors

Overdue invoices detected, spreadsheet updated, payment reminders sent , your agent handles accounts receivable

Build the capability set

Each Connector adds new actions and data without changing how you work.

Browse Connectors

01 9 capabilities

Gmelius

Turn Gmail into a collaborative workspace with shared inboxes, email delegation, and workflow automation for teams.

02 10 capabilities

Nylas

Equip your AI agent to manage emails, calendars, and contacts across all providers (Gmail, Outlook) through a single unified interaction.

03 10 capabilities

Missive

Collaborative email and shared inbox for teams.

04 12 capabilities

Hiver

Turn Gmail into a helpdesk with shared labels, email assignment, and SLA tracking that works inside the inbox your team already uses.

05 11 capabilities

AgentMail

Give your AI agents their own email inbox to read, send, and reply to messages natively.

06 5 capabilities

AfterLogic Aurora

Email and webmail management. manage folders, messages, and accounts via AI.

Bring your own AI

Change the model, client or framework. Keep Gmail connected.

Before you connect

Questions about Gmail.

The practical details behind the request, access and result.

Can the Gmail MCP search my old emails for specific info?

Yes, it can search your entire history. You can ask your agent to find specific threads, dates, or senders, and it will pull the relevant details for you.

Does the Gmail MCP support my Google Workspace account?

Yes, it supports both personal and enterprise Google Workspace accounts. It's designed to work with the same permissions you use daily.

Can I use the Gmail MCP to draft and send replies?

Yes, it can draft a response based on the context of your conversation for you to review, or send it immediately if you give the command.

How does the Gmail MCP help me organize my folders?

It can automatically apply labels, archive messages, and create new filters to sort your incoming mail so you can reach Inbox Zero faster.

Can the Gmail MCP find and download email attachments?

Yes, your agent can locate specific attachments within your emails and retrieve the data for you to use in your current project.

Is it possible to bulk update my emails using the Gmail MCP?

Yes, you can use it to perform bulk actions like marking dozens of messages as read or applying labels to a large group of emails at once.

Can the Gmail MCP manage my vacation auto-responder?

Yes, you can use your AI client to toggle your vacation settings on or off and check your current out-of-office status.

Can the AI send emails autonomously on my behalf?

Yes, if authorized by you in the conversational context. The send_email capability allows fully crafting, attaching subject lines, and dispatching payloads out of your alias.

How does searching work in a massively clogged inbox?

The integration exposes a wrapper around Google's native filtering syntax. You simply supply native params like "is:unread from:dev" and the egress bounds automatically stream only small context snippets.

Is my email data retained or trained by the server?

No, Vurb MCP architecture operates exclusively locally. The network connection executes your query endpoint-to-endpoint securely matching Google standard scopes directly to your client.

One connection away

Give your agent a direct line to Gmail.

Connect Gmail once. Keep it beside 5,900+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available