# Gmail MCP

> Use this tool when you need to streamline your email workflow and manage your Gmail account programmatically. The Gmail MCP provides 60+ tools for drafting, sending, retrieving, and organizing messages, solving problems such as email overload and disorganization. It takes inputs like CLIENT_ID, CLIENT_SECRET, and REFRESH_TOKEN, and outputs managed email messages and threads, making it ideal for automating email tasks and integrating with other applications.

Canonical page: https://skillsregistry.net/skills/shinzo-labs-gmail-mcp  
JSON: https://api.skillsregistry.net/v1/skills/shinzo-labs-gmail-mcp

## Description

Manage your emails effortlessly with 60+ tools for drafting, sending, retrieving, and organizing messages. Streamline your email workflow with complete Gmail API coverage, including label and thread management.

**Installation**

Google API Client Setup (once per organization):
1. Go to the Google Cloud Console (https://console.cloud.google.com/).
2. Create a new project or select an existing one.
3. Enable the Gmail API for your project.
4. Go to Credentials and create an OAuth 2.0 Client ID. Choose "Desktop app" for the client type.
5. Download and save the OAuth keys JSON as ~/.gmail-mcp/gcp-oauth.keys.json.
6. Note the CLIENT_ID and CLIENT_SECRET from this file.

Client OAuth (once per user):
1. Have the user copy ~/.gmail-mcp/gcp-oauth.keys.json to their computer at the same path.
2. Run npx @shinzolabs/gmail-mcp auth.
3. A browser window will open where the user may select a profile, review the requested scopes, and approve.
4. Note the file path mentioned in the success message (~/.gmail-mcp/credentials.json by default). This will contain the user's REFRESH_TOKEN.

Input the CLIENT_ID, CLIENT_SECRET, and REFRESH_TOKEN for your Smithery server and you're good to go!

## Trust

- **Trust score (0–1):** 0.50
- **Verification tier:** unverified

## Facts

- **Version:** 1.0.0
- **Skill type:** atomic
- **Execution layer:** container
- **Runtime environment:** vm
- **Category:** cloud-infra
- **Updated:** 2026-05-14

## Source

- **Source listing:** [Smithery](https://smithery.ai/server/shinzo-labs/gmail-mcp)

## Use it

Resolve this record through the SkillsRegistry MCP server (no auth, read-only):

```
claude mcp add --transport http --scope user skillsregistry https://api.skillsregistry.net/mcp
```

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_skill",
    "arguments": {
      "slug": "shinzo-labs-gmail-mcp"
    }
  }
}
```

REST: `GET https://api.skillsregistry.net/v1/skills/shinzo-labs-gmail-mcp` · pull for local use: `GET https://api.skillsregistry.net/v1/skills/shinzo-labs-gmail-mcp/pull`

---
SkillsRegistry indexes agent skills from public registries and GitHub. Skills we have analysed are scanned with Circle-IR and scored on six dimensions; each listing states its scan coverage. More: https://skillsregistry.net/llms.txt