Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use Gmail with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Manage your inbox from AI. read, search, organize, and reply to emails across your Gmail efficiently.

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 30 capabilities

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.

  1. 01

    Create label

    Labels act as tags. one message can have multiple labels. Use list_mailbox_labels to see existing labels before creating duplicates. Create a custom label

  2. 02

    Get label details

    Get details about a specific label

  3. 03

    Get thread details

    Returns the complete email chain with headers, bodies, and metadata for each message. Read all messages in a thread

  4. 04

    List mailbox labels

    System labels include INBOX, SENT, TRASH, SPAM, STARRED, UNREAD, IMPORTANT, etc. Use label IDs when modifying message labels. List all labels in the mailbox

Capability set02 / 08

05-08

4 capabilities in this set.

Part of 30 available through Gmail.

  1. 05

    Modify message labels

    Use label IDs (e.g. "UNREAD", "STARRED", "INBOX", or custom label IDs from list_mailbox_labels). Removing "UNREAD" marks as read. Add or remove labels from a message

  2. 06

    Trash gmail message

    Messages in trash are auto-deleted after 30 days. Use untrash_gmail_message to recover. Move a message to the trash

  3. 07

    Delete label

    System labels (INBOX, SENT, etc.) cannot be deleted. This is not reversible. Delete a label permanently

  4. 08

    Get draft

    Use this to review a draft before sending. Read a specific draft

Capability set03 / 08

09-12

4 capabilities in this set.

Part of 30 available through Gmail.

  1. 09

    List drafts

    Returns draft IDs and attached message snippets. Use get_draft for full content or send_draft to dispatch. List email drafts

  2. 10

    Get attachment

    Returns base64-encoded data and size. First use get_message_content to find attachment IDs in the message payload parts. Download an email attachment

  3. 11

    List inbox filters

    Filters automatically process incoming messages based on criteria (from, to, subject, query) and perform actions (add/remove labels, forward, archive, etc.). List inbox filter rules

  4. 12

    Verify API connection

    Check Gmail API connectivity

Capability set04 / 08

13-16

4 capabilities in this set.

Part of 30 available through Gmail.

  1. 13

    Get vacation settings

    Check vacation auto-responder status

  2. 14

    Delete draft

    This is not reversible. Delete a draft permanently

  3. 15

    Batch delete messages

    This is NOT reversible. messages cannot be recovered. Use trash instead for safe deletion. Permanently delete multiple messages

  4. 16

    Batch modify messages

    Useful for bulk operations like "mark all as read" (remove UNREAD) or "archive all" (remove INBOX). Provide message IDs as a JSON array string. Bulk-modify labels on multiple messages

Capability set05 / 08

17-20

4 capabilities in this set.

Part of 30 available through Gmail.

  1. 17

    Create draft

    The user can review and modify the draft in Gmail or send it later using send_draft. Safer than sending directly. Create an email draft

  2. 18

    Create inbox filter

    Criteria fields: from, to, subject, query, hasAttachment, negatedQuery. Action fields: addLabelIds, removeLabelIds, forward, star, markImportant. Provide criteria and action as JSON strings. Create an inbox filter rule

  3. 19

    Find emails from sender

    Shortcut for the "from:" Gmail search operator. Search emails by sender address

  4. 20

    Get gmail profile

    Use historyId with list_mailbox_history for change tracking. Get mailbox identity and stats

Capability set06 / 08

21-24

4 capabilities in this set.

Part of 30 available through Gmail.

  1. 21

    Get message content

    Use after list_gmail_messages to read specific emails. Read the full content of an email

  2. 22

    List gmail messages

    Use the "q" parameter for Gmail search syntax (e.g. "from:boss@company.com is:unread", "has:attachment", "newer_than:2d"). Returns message IDs and thread IDs. use get_message_content to read full details. List messages from the inbox

  3. 23

    List gmail threads

    Supports Gmail search syntax via "q". Threads group related messages together. List conversation threads

  4. 24

    List mailbox history

    Get the starting history ID from get_gmail_profile. Useful for incremental sync and change detection. Track mailbox changes since a point in time

Capability set07 / 08

25-27

3 capabilities in this set.

Part of 30 available through Gmail.

  1. 25

    List unread emails

    Equivalent to searching with "is:unread". List the latest unread messages

  2. 26

    Send draft

    The draft is removed after sending. Send an existing draft

  3. 27

    Send email

    Supports plain text and HTML body, CC, BCC, and reply threading via inReplyTo/references headers. The email is sent immediately. Compose and send an email

Capability set08 / 08

28-30

3 capabilities in this set.

Part of 30 available through Gmail.

  1. 28

    Untrash gmail message

    Recover a message from the trash

  2. 29

    Update draft

    The draft ID is required. get it from list_drafts. Edit an existing draft

  3. 30

    Update vacation settings

    Optionally restrict to contacts only or domain members. Dates are Unix timestamps in milliseconds. Toggle vacation auto-responder

Observed, not estimated

1080ms average. Fast in production.

Gmail is checked daily against the live service.

Daily averagePeak 1292ms
Aug 20Today
Fastest day
880ms
Slowest day
1292ms
14-day trend
Slowing+14%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 30 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of Gmail, so you can see the experience inside your AI.

It does not authenticate your account with Gmail. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

Gmail Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_wa8i0RmDTsJc5f8Q00AQRFjYSCGVye2I8kvXm00S/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Gmail capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "gmail-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_wa8i0RmDTsJc5f8Q00AQRFjYSCGVye2I8kvXm00S/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

FAQ

Questions Gmail owners ask.

  • 01

    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.

  • 02

    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.

  • 03

    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.

Explore

More in Industry Titans

Suggestions