Skyp's MCP (Model Context Protocol) server now includes tools that let an AI agent read your connected Gmail inbox and pull upcoming calendar events — without leaving the Skyp context. This is useful when you want an AI assistant to help you triage replies, spot meeting requests, or coordinate outreach based on your actual calendar availability.
Before you start
These tools are available to any AI agent or automation connected to Skyp via MCP. You'll need:
A Skyp account with at least one Gmail mailbox connected. You can connect one from Mailboxes.
An MCP client configured to connect to the Skyp MCP server (e.g. Claude Desktop, Cursor, Gemini, Slack, or a custom agent). See Using the Agents & API Dashboard for setup instructions.
Listing inbox messages
Use the list_inbox tool to fetch a list of messages from your Gmail inbox. The tool supports Gmail's full search syntax, so you can filter exactly what you need.
Example queries you can pass:
is:unread— unread messages onlyfrom:[email protected]— messages from a specific sendersubject:meeting— messages with "meeting" in the subjectnewer_than:7d— messages from the last 7 dayshas:attachment— messages with attachments
The tool returns message metadata and a short snippet for each result. To read the full body of a message, use the read_inbox_message tool with the message ID returned in the list.
You can also pass a page_token to paginate through large inboxes, and an optional account_email if you have multiple Gmail accounts connected to Skyp and want to specify which one to read from.
Reading a specific message
Use the read_inbox_message tool to get the full content of a single message.
Call list_inbox to find the message and note its ID.
Call read_inbox_message with that message ID.
The full email body, headers, and metadata are returned.
Listing upcoming calendar events
Use the list_calendar_events tool to extract upcoming events from your Gmail inbox. Because Skyp reads Google Calendar notification emails (rather than connecting directly to Google Calendar), no additional OAuth permission is required — just your connected Gmail account.
The tool scans for calendar notification emails from Google Calendar and extracts:
Event title, date, and time
Location (if included)
Attendees
You can control how far ahead to look (up to 90 days) and the maximum number of notification emails to scan. As with inbox tools, you can specify an account_email if multiple Gmail accounts are connected.
Example use cases
Triage hot leads: Ask your AI agent to scan for unread replies to a specific campaign and summarize sentiment before you start your day.
Avoid double-booking: Have the agent check your calendar before scheduling outreach calls, so it can suggest slots that don't conflict with existing meetings.
Spot meeting requests: Search for emails with "subject:meeting request" to quickly identify prospects who are ready to book.
Things to know
These tools read your inbox; they do not send or delete messages.
Calendar events are extracted from Gmail notification emails, not directly from Google Calendar. Events may be missing if Google Calendar notifications are turned off for your account.
If you have multiple Gmail mailboxes connected to Skyp, omitting account_email will default to your primary connected account. Manage your mailboxes from Mailboxes.