How to Use the Google Calendar MCP in Mastra AI

Q: How can Mastra AI search Google Calendar events effectively?

The searchevents tool allows your agent to query based on keywords or date ranges. It returns structured data that your workflow engine processes instantly.

Q: Can I approve Google Calendar actions in Mastra AI?

Enable requireToolApproval for sensitive tools like deleteevent. This forces a human-in-the-loop check before the action hits your calendar.

Automate complex scheduling workflows with Mastra AI and Google Calendar.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Google Calendar MCP to Mastra AI

Create your Vinkius account to connect Google Calendar to Mastra AI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Google Calendar with Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Handle multi-step logic with Mastra AI

Create agent workflows that chain `check_free_busy` and `create_event` with conditional logic. If a slot is booked, your agent automatically searches for the next available opening. Failed attempts trigger automatic retries. You define the flow once and the framework ensures the operation completes.

Execute precise calendar updates

Use `update_event` to modify existing meetings based on changing project requirements. Your agents maintain consistency across your schedule by syncing changes in real-time. This prevents manual entry errors. You define the parameters and the tool ensures the calendar reflects the latest status.

Monitor access with granular control

Audit who can view your data using `list_acl`. Your agents can report on sharing settings to ensure your security posture remains intact. It keeps your scheduling environment tidy. You can inspect `get_calendar_metadata` to verify that your agents are hitting the right calendars.

Setup guide

Set up Google Calendar MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Google Calendar tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "google-calendar-mcp-client",
  servers: {
    "google-calendar-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Google Calendar Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Google Calendar tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Google Calendar transactions"
);
console.log(result.text);

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Google Calendar. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Google Calendar now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Google Calendar MCP in Mastra AI

The `search_events` tool allows your agent to query based on keywords or date ranges. It returns structured data that your workflow engine processes instantly.

Yes. You configure the retry policy in your agent definition. It handles transient network issues while executing `list_events` or other read operations.

Enable `requireToolApproval` for sensitive tools like `delete_event`. This forces a human-in-the-loop check before the action hits your calendar.

You can register multiple server instances for different accounts. The agent selects the correct one based on your workflow configuration.

The server acts as a transient bridge. It processes your event records in memory and does not store your calendar information on our servers.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python