How to Use the Google Calendar MCP in OpenAI Agents SDK

Q: How does OpenAI Agents SDK discover Google Calendar tools?

The SDK uses the MCPServerStreamableHttp constructor to connect to the MCP Server endpoint. Once connected, your OpenAI Agents SDK agent automatically discovers all twelve tools, including createevent and listevents, with zero manual configuration.

Q: How do I handle time zone conflicts between Google Calendar and OpenAI Agents SDK?

The server passes timezone rules via getsettings to your OpenAI Agents SDK system. Your agent reads these rules to format timestamps correctly before calling createevent.

Q: Can the agent search for past meetings?

The searchevents tool lets your agent query past and future calendar entries. It uses simple text queries to find specific event history instantly.

Connect this Google Calendar MCP Server to OpenAI Agents SDK to write, modify, and inspect schedules without writing manual APIs.

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 OpenAI Agents SDK

Create your Vinkius account to connect Google Calendar to OpenAI Agents SDK 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 OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Securely scheduling meetings directly inside OpenAI Agents SDK.

The `create_event` tool allows your OpenAI Agents SDK agent to write new calendar entries directly to Google Calendar. By integrating this tool, your agent reads the user's intent, extracts dates, and writes the Google Calendar event payload directly into your OpenAI Agents SDK workflow. For rapid entries, the agent falls back to `quick_add_event` to parse natural language strings directly inside OpenAI Agents SDK. This setup passes through the OpenAI guardrails, letting you validate the payload before the write operation goes live on the target calendar.

Conflict-free scheduling with real-time slot checking.

The `check_free_busy` tool queries Google Calendar availability using this MCP integration to prevent double-booking. Your OpenAI Agents SDK agent runs this check to verify open slots, feeding the raw availability data into its planning loop. Once a free slot is confirmed, the agent calls `list_events` to double-check against adjacent conflicts on your Google Calendar. This workflow ensures your OpenAI Agents SDK systems never schedule overlapping Google Calendar appointments or trigger booking errors.

Modify and prune calendar events on the fly.

The `update_event` tool modifies existing event details, times, or attendees in Google Calendar based on chat instructions. If a meeting gets rescheduled, your OpenAI Agents SDK agent updates the specific event ID instead of deleting and recreating it. Whenever a Google Calendar appointment gets canceled, the agent invokes `delete_event` via the MCP Server to remove the entry instantly. Your OpenAI Agents SDK agent handles these changes autonomously while maintaining correct state across your Google Calendar.

Setup guide

Set up Google Calendar MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all Google Calendar tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Google Calendar tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Google Calendar tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="Google Calendar Agent",
            instructions="You have access to Google Calendar tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

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 OpenAI Agents SDK

The SDK uses the `MCPServerStreamableHttp` constructor to connect to the MCP Server endpoint. Once connected, your OpenAI Agents SDK agent automatically discovers all twelve tools, including `create_event` and `list_events`, with zero manual configuration.

Yes, configure input validation within your agent definitions before exposing tools like `delete_event`. This prevents your OpenAI Agents SDK agent from modifying critical schedules without explicit permission.

The server passes timezone rules via `get_settings` to your OpenAI Agents SDK system. Your agent reads these rules to format timestamps correctly before calling `create_event`.

The `search_events` tool lets your agent query past and future calendar entries. It uses simple text queries to find specific event history instantly.

Your connection to the Google Calendar MCP Server is completely private. All calendar events, user settings, and access control lists are processed in an ephemeral, zero-trust sandbox. Your credentials never touch our database, and the connection remains completely isolated.

Use it with your favorite AI tools

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

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript