Barie Gmail MCP

A Model Context Protocol (MCP) server for interacting with Gmail accounts.

Installation

Install with uvx:

uvx --from . barie-gmail-mcp --help

Or install with pip:

pip install -e .

Usage

Run the MCP server:

barie-gmail-mcp \
  --access-token "<access_token>" \
  --refresh-token "<refresh_token>" \
  --client-id "<google_client_id>" \
  --client-secret "<google_client_secret>" \
  --expiry "<optional_iso_expiry>" \
  --attachments-dir "./attachments"

Required arguments

• --access-token: OAuth2 access token
• --refresh-token: OAuth2 refresh token
• --client-id: Google OAuth client ID
• --client-secret: Google OAuth client secret

Optional arguments

• --expiry: Access token expiry in ISO format
• --attachments-dir: Local path for saving attachments
• --scopes: Optional custom scopes list

Features

• Draft, read, and send emails
• Read unread messages and search mail
• Label and folder management
• Email filter management
• Archive/restore and trash operations

Development

From the barie_gmail_mcp directory:

python server.py --help