LIAM Gmail

Secure Gmail access powered by CASA-compliant OAuth. Search emails, read messages, browse threads, and list labels—all through LIAM's enterprise-grade infrastructure.

Overview

This MCP server provides Gmail access through LIAM's CASA-compliant Google OAuth infrastructure. Users authenticate via LIAM, and all Gmail API calls are routed through LIAM's backend to preserve security and compliance.

Account Type: Creates lightweight "mcp" accounts that provide direct API access without Gmail watch notifications or automatic draft generation.

Tools

Messages

• gmail_list_messages - List messages with search queries
• gmail_get_message - Get a specific message by ID
• gmail_search_messages - Search using Gmail query syntax

Threads

• gmail_list_threads - List email threads (conversations)
• gmail_get_thread - Get a thread with all messages

Labels

• gmail_list_labels - List all labels

Profile

• gmail_get_profile - Get user's Gmail profile

Gmail Query Syntax

The query parameter supports Gmail's search syntax:

Query	Description
from:email@example.com	From specific sender
to:email@example.com	To specific recipient
subject:keyword	Subject contains keyword
is:unread	Unread messages
is:starred	Starred messages
has:attachment	Has attachments
after:2024/01/01	After date
before:2024/12/31	Before date
in:inbox	In inbox
label:custom-label	Has specific label

Combine queries: from:boss@company.com is:unread has:attachment

Setup

Prerequisites

• Dedalus API key
• Python 3.10+

Environment Variables

DEDALUS_API_KEY=dsk-live-your-key-here
DEDALUS_API_URL=https://api.dedaluslabs.ai
DEDALUS_AS_URL=https://as.dedaluslabs.ai

Local Development

cd gmail-liam-mcp
uv sync
uv run python main.py

Security

• Google credentials are encrypted at rest (AES-256-GCM)
• OAuth tokens never touch the MCP server directly
• Your credentials are never exposed to third parties

Support

• Email: support@doitliam.com

License

MIT License