Which integrations are available for this server?

Enables AI agents to interact with Gmail to search, list, and retrieve messages and conversation threads, manage labels, and access account profiles. Provides authenticated access to Gmail and account information via Google's OAuth infrastructure.

How do I use Gmail MCP Server (Powered by LIAM)?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Gmail MCP Server (Powered by LIAM) Find any unread emails from my boss about the project update." That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

LIAM Gmail MCP

Provided by LIAM (doitliam.com). This MCP server gives Gmail access using LIAM OAuth and Dedalus DAuth.

Hosted on Dedalus: sintem/gmail-mcp

Auth Flow (DAuth + LIAM OAuth)

Client connects to the MCP server on Dedalus.
Dedalus DAuth handles MCP authorization; if the Gmail connection is not yet authorized, the client receives a connect_url to start OAuth.
User completes LIAM OAuth (and Google consent) in the browser.
Dedalus AS stores the LIAM OAuth access token and issues a JWT containing connection handles (ddls:connections).
The MCP server uses Dedalus dispatch + the connection handle to call the Gmail API.

Tools

Tool	Description
`gmail_get_profile`	Get Gmail profile (email, message/thread counts)
`gmail_list_messages`	List messages with optional Gmail query
`gmail_get_message`	Get a specific message by ID
`gmail_send_message`	Send an email
`gmail_trash_message`	Move a message to trash
`gmail_untrash_message`	Remove a message from trash
`gmail_modify_message`	Add/remove labels on a message
`gmail_list_threads`	List email threads
`gmail_get_thread`	Get a specific thread by ID
`gmail_trash_thread`	Move a thread to trash
`gmail_untrash_thread`	Remove a thread from trash
`gmail_modify_thread`	Add/remove labels on a thread
`gmail_list_labels`	List all labels
`gmail_get_label`	Get label details by ID
`gmail_create_label`	Create a new label
`gmail_delete_label`	Delete a user label
`gmail_list_drafts`	List drafts
`gmail_get_draft`	Get a draft by ID
`gmail_create_draft`	Create a draft
`gmail_send_draft`	Send a draft
`gmail_delete_draft`	Delete a draft
`gmail_get_attachment`	Get a message attachment

Smoke tools (debug):

Tool	Description
`smoke_echo`	Echo input (sanity check)
`smoke_info`	Server info (sanity check)

Gmail Query Syntax

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

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

Setup

1. Environment

Create .env:

# Required
DEDALUS_API_KEY=dsk-live-your-key

# Optional (defaults shown)
DEDALUS_API_URL=https://api.dedaluslabs.ai
DEDALUS_AS_URL=https://as.dedaluslabs.ai

# MCP server slug (LIAM hosted or your own)
MCP_SERVER=sintem/gmail-mcp

# Gmail API base URL (optional override)
GMAIL_API_URL=https://gmail.googleapis.com

# Optional: direct LIAM OAuth token for local testing
LIAM_ACCESS_TOKEN=liam-jwt-here

2. Install

cd gmail-liam-mcp
uv sync --all-extras

3. Deploy to Dedalus

dedalus deploy

4. Test locally

OAuth (recommended, uses DAuth + LIAM OAuth):

python src/_client.py

Manual LIAM token (advanced/testing only):

# Interactive mode
python run.py

# Single query
python run.py "show my unread emails"

Project Structure

gmail-liam-mcp/
├── run.py            # Local test client with LIAM token
├── src/
│   ├── main.py       # MCP server (Dedalus entrypoint)
│   ├── gmail.py      # Tools (modular version)
│   ├── server.py     # Server config
│   └── _client.py    # OAuth/DAuth client example
├── pyproject.toml
├── .env.example
└── README.md