Gmail
Overview
SLUG: GMAIL
Description
Gmail is Google’s email service, featuring spam protection, search functions, and seamless integration with other G Suite apps for productivity
Authentication Details
OAuth2
Bearer Token
Connecting to Gmail
Create an auth config
Use the dashboard to create an auth config for the Gmail toolkit. This allows you to connect multiple Gmail accounts to Composio for agents to use.
Create and Get auth config ID
Click “Create Integration”. After creation, copy the displayed ID starting with ac_
. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database.
This ID will be used to create connections to the toolkit for a given user.
Connect Your Account
Using OAuth2
Using Bearer Token
Tools
Executing tools
To prototype you can execute some tools to see the responses and working on the Gmail toolkit’s playground
OpenAI (Python)
Anthropic (TypeScript)
Google (Python)
Vercel (TypeScript)
Tool List
GMAIL_CREATE_EMAIL_DRAFT
Tool Name: Create email draft
Description
Action Parameters
Action Response
GMAIL_DELETE_DRAFT
Tool Name: Delete Draft
Description
Action Parameters
Action Response
GMAIL_DELETE_MESSAGE
Tool Name: Delete message
Description
Action Parameters
Action Response
GMAIL_FETCH_EMAILS
Tool Name: Fetch emails
Description
Action Parameters
Action Response
GMAIL_FETCH_MESSAGE_BY_MESSAGE_ID
Tool Name: Fetch message by message ID
Description
Action Parameters
Action Response
GMAIL_GET_ATTACHMENT
Tool Name: Get Gmail attachment
Description
Action Parameters
Action Response
GMAIL_GET_CONTACTS
Tool Name: Get contacts
Description
Action Parameters
Action Response
GMAIL_LIST_DRAFTS
Tool Name: List drafts
Description
Action Parameters
Action Response
GMAIL_MOVE_TO_TRASH
Tool Name: Move to Trash
Description
Action Parameters
Action Response
GMAIL_PATCH_LABEL
Tool Name: Patch Label
Description
Action Parameters
Action Response
GMAIL_REPLY_TO_THREAD
Tool Name: Reply to email thread
Description
Action Parameters
Action Response
GMAIL_SEARCH_PEOPLE
Tool Name: Search People
Description
Action Parameters
Action Response
GMAIL_SEND_DRAFT
Tool Name: Send Draft
Description
Action Parameters
Action Response
GMAIL_SEND_EMAIL
Tool Name: Send Email
Description
Action Parameters
Action Response
GMAIL_ADD_LABEL_TO_EMAIL
Tool Name: Modify email labels
Description
Action Parameters
Action Response
GMAIL_CREATE_LABEL
Tool Name: Create label
Description
Action Parameters
Action Response
GMAIL_FETCH_MESSAGE_BY_THREAD_ID
Tool Name: Fetch Message by Thread ID
Description
Action Parameters
Action Response
GMAIL_GET_PEOPLE
Tool Name: Get People
Description
Action Parameters
Action Response
GMAIL_GET_PROFILE
Tool Name: Get Profile
Description
Action Parameters
Action Response
GMAIL_LIST_LABELS
Tool Name: List Gmail labels
Description
Action Parameters
Action Response
GMAIL_LIST_THREADS
Tool Name: List threads
Description
Action Parameters
Action Response
GMAIL_MODIFY_THREAD_LABELS
Tool Name: Modify thread labels
Description
Action Parameters
Action Response
GMAIL_REMOVE_LABEL
Tool Name: Remove label
Description
Action Parameters
Action Response