How to Use the SimplyBook.me MCP in OpenAI Agents SDK

Q: Can I check staff capacity using SimplyBook.me and OpenAI Agents SDK?

Yes. Your agent uses getworkcalendar to retrieve a unit’s current schedule for SimpleBook.me. This means you can verify if enough people are available before finalizing any booking.

Q: What happens when I update an appointment using SimplyBook.me and OpenAI Agents SDK?

The agent uses the updatebooking tool to modify existing SimpleBook.me appointments. This function requires the unique ID of the appointment, ensuring you hit the right record every time.

Q: Does SimplyBook.me support listing calendar events with OpenAI Agents SDK?

Absolutely. The agent uses listevents to pull specific class or general calendar entries for SimpleBook.me, giving you a view beyond just one-on-one bookings.

Q: Is data privacy handled when using SimplyBook.me and OpenAI Agents SDK?

This MCP Server interacts with client records (listclients) and booking details. When setting up your agent, make sure you're passing the necessary permissions to keep user data secure.

Automate complex scheduling logic with OpenAI Agents SDK.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect SimplyBook.me MCP to OpenAI Agents SDK

Create your Vinkius account to connect SimplyBook.me to OpenAI Agents SDK — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup SimplyBook.me with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Manage Staff Availability for OpenAI Agents SDK

Your agent checks staff schedules before booking. It calls `get_work_calendar` to pull a unit’s hours, so it knows exactly when people are free. If the agent needs to know if an existing appointment is still valid, it uses `list_bookings`. This gives a full list of all scheduled events for SimpleBook.me.

Handle Client Records and Service Lookup

Need to know who's coming in? The agent lists company clients using `list_clients`. It also pulls every service type available through `list_services`, making sure the booking matches what SimpleBook.me offers. Before creating anything, it lets you list all possible units (providers or locations) via `list_units` to narrow down options.

Process Booking Changes on the Fly

The agent can create a new booking with just a service ID, unit ID, and start time using `create_booking`. If plans change, calling `update_booking` adjusts an existing appointment without having to manually touch anything. If something goes wrong or needs canceling, the agent uses `cancel_booking`, which is important because that action can't be undone.

Setup guide

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

Create your Agent

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

Run the agent

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

The OpenAI Agents SDK lets your agent interact directly with the SimpleBook.me MCP Server tools. You don't write complex API calls; you just describe the task, and the agent figures out the right sequence of tool calls.

Yes. Your agent uses `get_work_calendar` to retrieve a unit’s current schedule for SimpleBook.me. This means you can verify if enough people are available before finalizing any booking.

The agent uses the `update_booking` tool to modify existing SimpleBook.me appointments. This function requires the unique ID of the appointment, ensuring you hit the right record every time.

Absolutely. The agent uses `list_events` to pull specific class or general calendar entries for SimpleBook.me, giving you a view beyond just one-on-one bookings.

This MCP Server interacts with client records (`list_clients`) and booking details. When setting up your agent, make sure you're passing the necessary permissions to keep user data secure.

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