How to Use the Truto Unified Calendar MCP in OpenAI Agents SDK

Q: How do I check event details using Truto Unified Calendar with OpenAI Agents SDK?

To get full details on any specific event, call getevent. This returns the title, location, attendees, and whether it's recurring. It pulls all that data from whichever underlying provider was used.

Q: Can I list multiple calendars using Truto Unified Calendar with OpenAI Agents SDK?

Yep. The listcalendars tool handles this by giving you a unified view of every connected calendar ID. This makes it easy for your agent to pick the right calendar without knowing the provider's specific API.

Q: What if I need to find out when people are free using Truto Unified Calendar with OpenAI Agents SDK?

You use getfreebusy. You pass in a target calendar ID and a time range. The tool then returns the availability blocks, marking them as either 'free' or 'busy,' all normalized for your agent.

Q: How do I ensure my agents can write events using Truto Unified Calendar with OpenAI Agents SDK?

You call createevent. Just make sure you pass the correct calendar ID, title, and start/end times in ISO format. The action writes directly to the underlying provider.

Schedule, check, and sync any event across Google or Outlook using your AI client.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Truto Unified Calendar MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Manage events with the MCP Server

The `create_event` tool lets you schedule something new. You just provide a calendar ID, title, and start/end times in ISO format; Truto writes that event to the actual provider—like Google or Outlook—in real time. The `update_event` tool changes existing events. Give it an event ID and a JSON object with the fields you want to change, and those modifications pass through immediately to the underlying service.

Check availability for your AI client

Want to know if someone's free? Use `get_free_busy` by passing a calendar ID and the date range. The tool returns time blocks showing exactly when that calendar is available or booked, all formatted in Truto's unified system. Don't forget to check connections first. `validate_connection` checks credentials and permissions for any integrated account you want your agent to use.

List calendars using the MCP Server

You can list all connected accounts with `list_connections`. This shows which calendar providers are linked up, their current authentication status, and general metadata. For scheduling purposes, `list_calendars` gives you a quick view of every calendar available through Truto's unified API. It normalizes the data across Google Calendar, Outlook, and other services so your agent doesn't care where the calendar actually lives.

Setup guide

Set up Truto Unified 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 Truto Unified Calendar tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives Truto Unified 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 Truto Unified 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="Truto Unified Calendar Agent",
            instructions="You have access to Truto Unified 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 Truto. 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 Truto Unified 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 Truto Unified Calendar MCP in OpenAI Agents SDK

To get full details on any specific event, call `get_event`. This returns the title, location, attendees, and whether it's recurring. It pulls all that data from whichever underlying provider was used.

Yep. The `list_calendars` tool handles this by giving you a unified view of every connected calendar ID. This makes it easy for your agent to pick the right calendar without knowing the provider's specific API.

You use `get_free_busy`. You pass in a target calendar ID and a time range. The tool then returns the availability blocks, marking them as either 'free' or 'busy,' all normalized for your agent.

You call `create_event`. Just make sure you pass the correct calendar ID, title, and start/end times in ISO format. The action writes directly to the underlying provider.

This MCP Server touches connection credentials, calendar metadata, and event scheduling data (including titles, dates, attendees, and locations).

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