blink-google-gmail

name	blink-google-gmail
description	Read, search, send, and manage Gmail emails and labels. Use when asked to check email, compose or send messages, search inbox, organize with labels, or manage email threads. Requires a linked Google connection.
metadata	{"blink":{"requires_env":["BLINK_API_KEY","BLINK_AGENT_ID"],"connector":"google_gmail"}}

Blink Gmail

Access the user's Gmail inbox. Provider key: google_gmail or composio_gmail (check blink connector status for the exact key). Base URL: https://gmail.googleapis.com/gmail/v1/ — endpoints below are relative to this.

List messages (inbox)

blink connector exec google_gmail /users/me/messages GET \
  '{"labelIds": "INBOX", "maxResults": 20}'

Search messages

blink connector exec google_gmail /users/me/messages GET \
  '{"q": "from:[e-mail] is:unread", "maxResults": 10}'

Get full message content

blink connector exec google_gmail /users/me/messages/MESSAGE_ID GET \
  '{"format": "full"}'

Send an email

blink connector exec google_gmail /users/me/messages/send POST '{
  "raw": "'$(echo -e "To: [e-mail]\r\nSubject: Hello\r\nContent-Type: text/plain\r\n\r\nHello from your agent!" | base64 -w 0 | tr '+/' '-_' | tr -d '=')'"
}'

List labels

blink connector exec google_gmail /users/me/labels GET

Modify message labels (mark as read)

blink connector exec google_gmail /users/me/messages/MESSAGE_ID/modify POST '{
  "removeLabelIds": ["UNREAD"]
}'

Move to trash

blink connector exec google_gmail /users/me/messages/MESSAGE_ID/trash POST '{}'

List threads

blink connector exec google_gmail /users/me/threads GET \
  '{"labelIds": "INBOX", "maxResults": 10}'

Get a thread

blink connector exec google_gmail /users/me/threads/THREAD_ID GET

Common use cases

• "Check my unread emails" → list messages with q: "is:unread" filter
• "What emails did I get from Sarah today?" → search from:sarah@... after:today
• "Send John a meeting confirmation" → compose and send email
• "Mark all emails from newsletter as read" → list + modify each
• "What's the latest update on project X?" → search for "project X" in inbox
• "Archive old emails" → modify labels to remove INBOX