README.md
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_urlto 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
License
MIT
Tools 22
gmail_get_profileGet Gmail profile including email and message/thread counts.gmail_list_messagesList messages with optional Gmail query.gmail_get_messageGet a specific message by ID.gmail_send_messageSend an email.gmail_trash_messageMove a message to trash.gmail_untrash_messageRemove a message from trash.gmail_modify_messageAdd/remove labels on a message.gmail_list_threadsList email threads.gmail_get_threadGet a specific thread by ID.gmail_trash_threadMove a thread to trash.gmail_untrash_threadRemove a thread from trash.gmail_modify_threadAdd/remove labels on a thread.gmail_list_labelsList all labels.gmail_get_labelGet label details by ID.gmail_create_labelCreate a new label.gmail_delete_labelDelete a user label.gmail_list_draftsList drafts.gmail_get_draftGet a draft by ID.gmail_create_draftCreate a draft.gmail_send_draftSend a draft.gmail_delete_draftDelete a draft.gmail_get_attachmentGet a message attachment.Environment Variables
DEDALUS_API_KEYrequiredAPI key for Dedalus authenticationDEDALUS_API_URLBase URL for Dedalus APIDEDALUS_AS_URLBase URL for Dedalus ASMCP_SERVERMCP server slugGMAIL_API_URLGmail API base URL overrideLIAM_ACCESS_TOKENDirect LIAM OAuth token for local testingTry it
→List all my unread emails from the last 24 hours.
→Find the latest thread from my boss and summarize the last three messages.
→Create a new label called 'Project Alpha' and move the most recent email from that sender into it.
→Draft a reply to the latest email in my inbox thanking them for the update.
→Search for emails with attachments from last month.