How to Use the Clockwise MCP in OpenAI Agents SDK

Get production-safe scheduling agents running with the Clockwise MCP Server and OpenAI Agents SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Clockwise MCP to OpenAI Agents SDK

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Protect focus time during high-load sprint cycles

`get_focus_time` retrieves the exact boundary limits driving active Deep Work blocks for your engineers. Your production agent checks these periods before suggesting any meeting times, ensuring heads-down work stays protected. To adjust these limits on the fly, the agent triggers `update_preferences` with validated payloads. This prevents your team from getting buried under a mountain of back-to-back status updates.

Automate team scheduling via OpenAI Agents SDK

`get_team_availability` calculates free time slots across your entire engineering group by querying live cloud calendars. The SDK routes this availability data directly to your coordination agent to find the perfect slot. Once the agent locates a window, it uses `get_calendar_events` to double-check for conflicts. This keeps scheduling automated but safe, avoiding overlapping double-bookings.

Control calendar automation with hard guardrails

`toggle_autopilot` mutates the active scheduling engine to let Clockwise automatically shift meetings to better times. Your agent toggles this state only when specific safety guardrails on the OpenAI dashboard are met. The agent verifies current settings first using `get_autopilot_status` to prevent circular updates. This ensures your MCP integration avoids infinite loops.

Setup guide

Set up Clockwise 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 Clockwise tools at runtime.
3

Create your Agent

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

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Clockwise 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="Clockwise Agent",
            instructions="You have access to Clockwise 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 Clockwise. 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 Clockwise 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 Clockwise MCP in OpenAI Agents SDK

Install the OpenAI SDK and initialize the streamable HTTP server using your Vinkius endpoint. Pass the server instance directly into the Agent constructor under the mcp_servers parameter. The SDK auto-discovers all ten scheduling tools instantly.

You control this MCP Server through the SDK's built-in tool filtering and agent handoff mechanics. You can assign read-only tools like `get_calendar_events` to a triage agent while keeping mutation tools locked down. This ensures your calendar state remains secure.

The SDK relies on built-in retries and error handling to manage API limits gracefully. When tools like `get_time_insights` pull heavy analytics, the framework queues requests to prevent failures. You can monitor all these calls directly on your OpenAI developer dashboard.

You track every mutation through the OpenAI dashboard's execution logs. Every time the agent runs `update_preferences`, the exact payload and response are saved. This gives you a clean audit trail of your schedule changes.

Vinkius runs the server in an ephemeral, zero-trust sandbox that never stores your calendar events or user preferences. Only the active OpenAI agent processes the raw JSON payloads during execution. Your organizational data remains completely isolated from external storage.

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