Domain knowledge for your AI assistant — workflow patterns, data model concepts, and gotchas for Gmail tools.
26 tools
SKILL.md
Gmail
SKILL.md
Domain knowledge for Gmail API tools — inbox, threads, labels, drafts, filters
Gmail
Data Model
Messages are individual emails. Each has an id; list via gmail_list_messages with query (e.g. has:attachment, newer_than:7d). Fetch content with gmail_fetch_messages_details or gmail_get_message_content.
Threads group related messages. List with gmail_list_threads; fetch with gmail_fetch_threads_details or gmail_get_thread_content.
Labels are folders/tags. System labels (INBOX, SENT, TRASH) have IDs like INBOX. Custom labels from gmail_list_labels. Apply/remove via gmail.modify scope.
Drafts are unsent messages. List with gmail_list_drafts; create/update via compose scope.
Filters auto-apply labels or forward. List with gmail_list_filters; manage via gmail.settings.basic.
History tracks changes. Use gmail_list_history_changes with startHistoryId for incremental sync.
Gotchas
historyId: Returned with message/thread fetches. Use for incremental sync; don't lose it.
Message ID vs thread ID: Different. Use message id for single-message ops; thread id for thread-level fetch.
Batch fetch: gmail_get_messages_content_batch for multiple messages in one call when you have many ids.
Use with Gmail Bundle
This skill teaches your AI assistant domain knowledge. To actually execute Gmail API calls, enable the MCP bundle — the skill and bundle work together.
Ready to use Gmail?
Install the skill for domain knowledge, enable the bundle for authenticated tool access