LABSCO SUMMARY

An agent can run a mailbox, not only read it.

What it takes off you is the handling: find the thread, label it, draft the reply, send it — and the parts nobody opens the settings page for, like a filter, a forwarding address or a vacation responder, are the same kind of call as the rest.

What it is

A Gmail server that follows the Gmail API surface closely rather than reducing it: the mailbox, and also the settings most integrations leave out — filters, forwarding, aliases, delegates, S/MIME.

What you get

List, read, relabel, trash and permanently delete messages — one at a time or a batch in a single call
The same over threads, and attachments fetched by message
Drafts created, listed, read, deleted and sent
Labels created, updated, patched and deleted, with colours and visibility
Settings: filters, forwarding addresses and auto-forwarding, IMAP and POP, language, vacation responder, delegates
Send-as aliases including signature and verification, and S/MIME configs per alias
The account profile, and a mailbox watch that can be started and stopped

Requirements

npx on your PATH, and a Google account authorized to it. Every tool checks the OAuth2 credentials before it reaches Gmail, so the authorization is what has to be in place first.

Setup effort

Follow the published steps

See installation options

USE CASES

01

Getting through an inbox

Search the mailbox on the same query syntax Gmail takes, open what matches, and label, archive or bin it — one message at a time, or a batch in a single call.

list_messagesget_messagemodify_messagebatch_modify_messagestrash_message

02

Drafting a reply for someone to check first

Find the thread, read what was said, and leave a draft in place. Nothing goes out until the draft is sent, so the review step stays where it belongs.

list_threadsget_threadcreate_draftsend_draft

03

Putting a filing system in place

Create the labels you want, check them against what already exists, and apply them across a batch of messages in one call instead of dragging them one by one.

create_labellist_labelsbatch_modify_messages

04

Finding the file someone emailed you

Narrow the mailbox to the message that carried it, open the message, and pull the attachment down by its id rather than scrolling for the thread.

list_messagesget_messageget_attachment

05

Auditing where your mail actually goes

Forwarding, filters and delegates are three separate settings pages and each can send mail somewhere you have forgotten about. Read all of them back in one pass.

get_auto_forwardinglist_forwarding_addresseslist_filterslist_delegates

06

Arranging cover before you go away

Set the vacation responder with its own subject and window, give a colleague delegate access, and confirm which addresses your mail can go out as.

update_vacationadd_delegatelist_send_as

64 tools

Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.

`add_delegate`

Adds a delegate to the specified account

BEFORE YOU INSTALL

What to know first

Tools you get

64 tools when we connected. update_draft is documented but cannot be called. Several tools act on a live mailbox: send_message sends mail, delete_message and batch_delete_messages delete permanently, and the settings tools change forwarding, delegates, filters and send-as aliases.

Requires

npx on PATH

CONTEXT COST

Moderate Standing cost

Rated by the size of the 64 tool definitions that ride along on every turn, not by how many there are

INSTALLATION

Connect your client

Server setup

Go to the Google Cloud Console (https://console.cloud.google.com), create a new project or select an existing one, and enable the Gmail API for it.

Go to Credentials and create an OAuth 2.0 Client ID. Choose "Desktop app" for the client type.

Download and save the OAuth keys JSON as ~/.gmail-mcp/gcp-oauth.keys.json.

Then, once per user, run:

TERMINAL

npx @shinzolabs/gmail-mcp auth

A browser window will open where you may select a profile, review the requested scopes, and approve.

MCP Clients

Any MCP client — Smithery

ANY MCP CLIENT — SMITHERY · TERMINAL

npx -y @smithery/cli install @shinzo-labs/gmail-mcp

Any MCP client — npx

ANY MCP CLIENT — NPX · JSON

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "@shinzolabs/gmail-mcp"
      ]
    }
  }
}

Any MCP client — local build

ANY MCP CLIENT — LOCAL BUILD · TERMINAL

git clone https://github.com/shinzo-labs/gmail-mcp.git
cd gmail-mcp
pnpm i && pnpm build

Add the following to your MCP client config.json:

ANY MCP CLIENT — LOCAL BUILD · JSON

{
  "mcpServers": {
    "gmail": {
      "command": "node",
      "args": [
        "<YOUR_PATH_TO_GMAIL_MCP>/dist/index.js"
      ]
    }
  }
}

Gmail MCP Server by Shinzo Labs

An agent can run a mailbox, not only read it.

What it is

What you get

Requirements

Setup effort

Getting through an inbox

Drafting a reply for someone to check first

Putting a filing system in place

Finding the file someone emailed you

Auditing where your mail actually goes

Arranging cover before you go away

64 tools

add_delegate

batch_delete_messages

batch_modify_messages

create_draft

create_filter

create_forwarding_address

create_label

create_send_as

delete_draft

delete_filter

delete_forwarding_address

delete_label

delete_message

delete_send_as

delete_smime_info

delete_thread

get_attachment

get_auto_forwarding

get_delegate

get_draft

get_filter

get_forwarding_address

get_imap

get_label

get_language

get_message

get_pop

get_profile

get_send_as

get_smime_info

get_thread

get_vacation

insert_smime_info

list_delegates

list_drafts

list_filters

list_forwarding_addresses

list_labels

list_messages

list_send_as

list_smime_info

list_threads

modify_message

modify_thread

patch_label

patch_send_as

remove_delegate

send_draft

send_message

set_default_smime_info

stop_mail_watch

trash_message

trash_thread

untrash_message

untrash_thread

update_auto_forwarding

update_imap

update_label

update_language

update_pop

update_send_as

update_vacation

verify_send_as

watch_mailbox

What to know first

Tools you get

Requires

`add_delegate`

`batch_delete_messages`

`batch_modify_messages`

`create_draft`

`create_filter`

`create_forwarding_address`

`create_label`

`create_send_as`

`delete_draft`

`delete_filter`

`delete_forwarding_address`

`delete_label`

`delete_message`

`delete_send_as`

`delete_smime_info`

`delete_thread`

`get_attachment`

`get_auto_forwarding`

`get_delegate`

`get_draft`

`get_filter`

`get_forwarding_address`

`get_imap`

`get_label`

`get_language`

`get_message`

`get_pop`

`get_profile`

`get_send_as`

`get_smime_info`

`get_thread`

`get_vacation`

`insert_smime_info`

`list_delegates`

`list_drafts`

`list_filters`

`list_forwarding_addresses`

`list_labels`

`list_messages`

`list_send_as`

`list_smime_info`

`list_threads`

`modify_message`

`modify_thread`

`patch_label`

`patch_send_as`

`remove_delegate`

`send_draft`

`send_message`

`set_default_smime_info`

`stop_mail_watch`

`trash_message`

`trash_thread`

`untrash_message`

`untrash_thread`

`update_auto_forwarding`

`update_imap`

`update_label`

`update_language`

`update_pop`

`update_send_as`

`update_vacation`

`verify_send_as`

`watch_mailbox`