Last updated: 4 July 2026

Gmail

Gmail

Live
Auth: OAuth (Connect Link) · Plans: Free, Starter, Business, Enterprise · Tools: 8 · Category: Collaboration

Search, read, and send Gmail messages — and manage labels — through your AI assistant.

Who needs this: Professionals who want AI to find, summarise, and act on emails without switching to Gmail.

Example questions once connected

  • Find all emails from our KRA supplier this month
  • Summarise the last 5 emails from the accounts team
  • Send a reply to the Juhudi Hardware invoice thread asking for a revised quote
  • Label all emails from [email protected] as "Msharti Support"

Step-by-step setup

  1. Open the connector in your Msharti dashboard. Go to Connectors → Gmail → Connect. Msharti creates a unique OAuth link. Click Open in Browser.
  2. Log in with your Gmail account. A consent screen lists what Msharti can access. Review the permissions and click Accept or Continue.
  3. Confirm the connection in Msharti. You will be redirected back to the dashboard. The connector shows Connected with a green dot. Tokens are stored securely and refreshed automatically.

Tool reference

These are the tools the AI can call on this connector. Each tool fires automatically when you ask a relevant question.

search_emails() Search Gmail messages using natural language or Gmail search operators.
Inputs query string (AI translates to Gmail search), optional: max_results, date_range
Try asking "Find all unread emails from suppliers sent this week"
Returns 7 unread supplier emails. Most recent: Juhudi Hardware (2 hours ago) — subject: "Revised June Invoice". Oldest: Mzigo Freight (3 days ago).
send_email() Send an email from the connected Gmail account.
Inputs to, subject, body, optional: cc, bcc, reply_to_message_id
Try asking "Send an email to [email protected] asking for the June invoice to be resent"
Returns Email sent to [email protected]. Subject: "June Invoice Request". Delivered at 14:23.
list_labels() List all Gmail labels and their unread/total message counts.
Inputs none
Try asking "What labels do I have and how many unread messages are in each?"
Returns 8 labels. Inbox: 14 unread. Suppliers: 3 unread. Finance: 0 unread. Msharti Support: 1 unread.
get_thread() Retrieve all messages in a Gmail thread, in order.
Inputs thread_id or subject keyword to find thread
Try asking "Show me the full email thread about the June M-Pesa reconciliation"
Returns 4 messages. Started: 10 Jun by [email protected]. Last reply: 12 Jun by you. Summary: dispute over KES 85,000 unmatched transaction — resolved, to be posted as journal entry.
create_draft() Create a Gmail draft without sending it.
Inputs to, subject, body, optional: cc
Try asking "Draft a reply to the Juhudi invoice thread asking them to confirm their bank details"
Returns Draft created. To: [email protected]. Subject: "Re: June Invoice — Bank Details Confirmation". Ready to review in your Drafts folder.

Limits

  • Delegated permissions only — the AI can only read and send as you, not as another user.
  • Attachments are not downloaded or parsed in this version.
  • Gmail API rate limit: 250 quota units/user/second. Msharti handles throttling automatically.

Related connectors

OL
Outlook
Search emails, read calendars, send messages, and schedule events through Microsoft Outlook.
 GD
Google Drive
List, search, read, create, and share files in Google Drive through your AI.
 NO
Notion
Query Notion databases, create pages, and update content through your AI assistant.
Need help? [email protected] — Nairobi-based, same time zone.