How to Use the Calendly MCP in Pydantic AI

Q: How do I configure Calendly with Pydantic AI?

Install the pydantic-ai-slimmcp package. Initialize an MCPToolset with your Vinkius HTTP endpoint. Pass it to the toolsets parameter when defining your Agent.

Type-safe Calendly scheduling for Pydantic AI agents.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Calendly MCP to Pydantic AI

Create your Vinkius account to connect Calendly to Pydantic 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 Calendly with Pydantic AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Connect Calendly to Pydantic AI

Scheduling agents fail when APIs return unexpected formats. This MCP integration guarantees type safety by validating every response against Pydantic models at runtime. You initialize the connection using MCPToolset with your HTTP endpoint. If the API changes or returns a missing field, your agent fails loudly with a validation error. You never get silent corruption or hallucinated time slots. The framework forces strict adherence to the schema for tools like `get_user` and `get_event_type`.

Read and validate availability schedules

Finding open slots requires precise data handling. Your agent executes `get_available_times` with an explicit date range. Pydantic AI catches any malformed date strings before they reach the language model. Because this operates as a standard MCP Server, you can switch between OpenAI, Anthropic, or local models without rewriting your scheduling logic. The model-agnostic design means the tool interactions remain identical. Your agent always receives correctly typed availability objects from `list_availability`.

Safely manage meetings and invitees

The MCP schema ensures bad arguments get rejected immediately. When an agent attempts to run `cancel_event`, the framework ensures the tracking UUID and optional cancellation reason match the required types. Destructive actions demand this kind of strict validation. Reading meeting details works the same way. The `list_invitees` tool pulls attendee lists, and `get_scheduled_event` fetches full meeting details. Because you define the expected structure, the agent processes the exact names, emails, and timezones it needs.

Setup guide

Set up Calendly MCP in Pydantic AI

Prerequisites

Python 3.10+ installed
pydantic-ai-slim[fastmcp] package
Active Vinkius subscription with a valid endpoint token

1

Install Pydantic AI with FastMCP
Run pip install "pydantic-ai-slim[fastmcp]". The FastMCP toolset replaces the deprecated MCPServerHTTP class with full protocol support.
2

Configure the FastMCPToolset
Pass a JSON-style config dict to FastMCPToolset with your Vinkius URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. Supports Streamable HTTP, SSE, and Stdio transports.
3

Create and run your agent
Pass the toolset to Agent(toolsets=[toolset]) and call agent.run(). Swap openai:gpt-4o for any supported model — Anthropic, Google, Mistral, or Groq.

agent.py

from pydantic_ai import Agent
from pydantic_ai.toolsets.fastmcp import FastMCPToolset

toolset = FastMCPToolset({
    "mcpServers": {
        "calendly-mcp": {
            "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
        }
    }
})

agent = Agent(
    "openai:gpt-4o",
    toolsets=[toolset],
    system_prompt="You have access to Calendly tools.",
)

result = await agent.run("List recent Calendly transactions")
print(result.output)

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 Calendly. 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 Calendly 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 Calendly MCP in Pydantic AI

Install the pydantic-ai-slim[mcp] package. Initialize an MCPToolset with your Vinkius HTTP endpoint. Pass it to the toolsets parameter when defining your Agent.

The framework strictly validates all inputs and outputs. When your agent calls get_available_times, Pydantic ensures the returned data structures match the defined schema before passing them to the LLM.

We recommend Streamable HTTP for external services. The older MCPServerHTTP method is deprecated. Pass your Vinkius URL directly to MCPToolset as a string.

You certainly can. The framework is completely model-agnostic. As long as the local model supports tool calling, it can interact with the scheduling endpoints just like a commercial API.

Your data remains secure through ephemeral processing. When your agent retrieves names, emails, and scheduling URLs via get_user, the MCP server executes the request in a completely isolated sandbox. Vinkius drops the connection and wipes the memory the moment the request finishes.

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