SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

How to integrate Cal MCP with Pydantic AI

Connect Pydantic AI to Cal MCP. Check if your google calendar is synced, cancel a meeting using its unique id, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Cal logoCal
Api KeyOauth2

Cal is a meeting scheduling platform that offers shareable booking links and real-time calendar syncing. It streamlines the process of finding mutual availability to make scheduling effortless.

168 Tools

Introduction

This guide walks you through connecting Cal to Pydantic AI using the Composio tool router. By the end, you'll have a working Cal agent that can create and reschedule bookings, check available slots, manage event types, set availability schedules, and connect your calendars through natural language commands.

This guide will help you understand how to give your Pydantic AI agent real control over a Cal account through Composio's Cal MCP server.

Before we dive in, let's take a quick look at the key ideas and tools involved.

Also integrate Cal with

Claude CodeClaude CoworkOpenAI Agents SDKClaude Agent SDKMuseCodexOpenClawHermesAtomic AgentGoogle ADKLangChainVercel AI SDKMastra AILlamaIndexCrewAIAutoGen

TL;DR

Here's what you'll learn:
  • How to set up your Composio API key and User ID
  • How to create a Composio Tool Router session for Cal
  • How to attach an MCP Server to a Pydantic AI agent
  • How to stream responses and maintain chat history
  • How to build a simple REPL-style chat interface to test your Cal workflows

What is Pydantic AI?

Pydantic AI is a Python framework for building AI agents with strong typing and validation. It leverages Pydantic's data validation capabilities to create robust, type-safe AI applications.

Key features include:

  • Type Safety: Built on Pydantic for automatic data validation
  • MCP Support: Native support for Model Context Protocol servers
  • Streaming: Built-in support for streaming responses
  • Async First: Designed for async/await patterns

What is the Cal MCP server, and what's possible with it?

The Cal MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Cal account. It provides structured and secure access to your bookings, event types, calendars, attendees, and teams, so your agent can review bookings, manage attendees, update event types, check availability, and organize team scheduling on your behalf.

  • Booking and attendee management: Have your agent review team bookings, edit booking details, add attendees, and list everyone attending your scheduled events.
  • Event type updates: Direct your agent to list your event types, edit individual event types, or update event types used by a team.
  • Calendar and availability checks: Let the agent list connected calendars, view destination calendars, check busy times for conflicts, and connect another calendar when needed.
  • Slot reservations: Instruct your agent to temporarily reserve an available slot for a bookable event while a guest completes the booking.
  • Team and profile administration: Have your agent review teams and memberships, find organization users, and create or update team profiles with scheduling, privacy, and branding preferences.

What is the Composio tool router, and how does it fit here?

What is Composio SDK?

Composio's Composio SDK helps agents find the right tools for a task at runtime. You can plug in multiple toolkits (like Gmail, HubSpot, and GitHub), and the agent will identify the relevant app and action to complete multi-step workflows. This can reduce token usage and improve the reliability of tool calls. Read more here: Getting started with Composio SDK

The tool router generates a secure MCP URL that your agents can access to perform actions.

How the Composio SDK works

The Composio SDK follows a three-phase workflow:

  1. Discovery: Searches for tools matching your task and returns relevant toolkits with their details.
  2. Authentication: Checks for active connections. If missing, creates an auth config and returns a connection URL via Auth Link.
  3. Execution: Executes the action using the authenticated connection.

Step-by-step Guide

Step by step09 STEPS
1

Prerequisites

Before starting, make sure you have:
  • Python 3.9 or higher
  • A Composio account with an active API key
  • Basic familiarity with Python and async programming
2

Getting API Keys for OpenAI and Composio

OpenAI API Key
  • Go to the OpenAI dashboard and create an API key. You'll need credits to use the models, or you can connect to another model provider.
  • Keep the API key safe.
Composio API Key
  • Log in to the Composio dashboard.
  • Navigate to your API settings and generate a new API key.
  • Store this key securely as you'll need it for authentication.
3

Install dependencies

bash
pip install composio pydantic-ai python-dotenv

Install the required libraries.

What's happening:

  • composio connects your agent to external SaaS tools like Cal
  • pydantic-ai lets you create structured AI agents with tool support
  • python-dotenv loads your environment variables securely from a .env file
4

Set up environment variables

bash
COMPOSIO_API_KEY=your_composio_api_key_here
USER_ID=your_user_id_here
OPENAI_API_KEY=your_openai_api_key

Create a .env file in your project root.

What's happening:

  • COMPOSIO_API_KEY authenticates your agent to Composio's API
  • USER_ID associates your session with your account for secure tool access
  • OPENAI_API_KEY to access OpenAI LLMs
5

Import dependencies

python
import asyncio
import os
from dotenv import load_dotenv
from composio import Composio
from pydantic_ai import Agent
from pydantic_ai.mcp import MCPServerStreamableHTTP

load_dotenv()
What's happening:
  • We load environment variables and import required modules
  • Composio manages connections to Cal
  • MCPServerStreamableHTTP connects to the Cal MCP server endpoint
  • Agent from Pydantic AI lets you define and run the AI assistant
6

Create a Tool Router Session

python
async def main():
    api_key = os.getenv("COMPOSIO_API_KEY")
    user_id = os.getenv("USER_ID")
    if not api_key or not user_id:
        raise RuntimeError("Set COMPOSIO_API_KEY and USER_ID in your environment")

    # Create a Composio Tool Router session for Cal
    composio = Composio(api_key=api_key)
    session = composio.create(
        user_id=user_id,
        toolkits=["cal"],
    )
    url = session.mcp.url
    if not url:
        raise ValueError("Composio session did not return an MCP URL")
What's happening:
  • We're creating a Tool Router session that gives your agent access to Cal tools
  • The create method takes the user ID and specifies which toolkits should be available
  • The returned session.mcp.url is the MCP server URL that your agent will use
7

Initialize the Pydantic AI Agent

python
# Attach the MCP server to a Pydantic AI Agent
cal_mcp = MCPServerStreamableHTTP(url, headers={"x-api-key": COMPOSIO_API_KEY})
agent = Agent(
    "openai:gpt-5",
    toolsets=[cal_mcp],
    instructions=(
        "You are a Cal assistant. Use Cal tools to help users "
        "with their requests. Ask clarifying questions when needed."
    ),
)
What's happening:
  • The MCP client connects to the Cal endpoint
  • The agent uses GPT-5 to interpret user commands and perform Cal operations
  • The instructions field defines the agent's role and behavior
8

Build the chat interface

python
# Simple REPL with message history
history = []
print("Chat started! Type 'exit' or 'quit' to end.\n")
print("Try asking the agent to help you with Cal.\n")

while True:
    user_input = input("You: ").strip()
    if user_input.lower() in {"exit", "quit", "bye"}:
        print("\nGoodbye!")
        break
    if not user_input:
        continue

    print("\nAgent is thinking...\n", flush=True)

    async with agent.run_stream(user_input, message_history=history) as stream_result:
        collected_text = ""
        async for chunk in stream_result.stream_output():
            text_piece = None
            if isinstance(chunk, str):
                text_piece = chunk
            elif hasattr(chunk, "delta") and isinstance(chunk.delta, str):
                text_piece = chunk.delta
            elif hasattr(chunk, "text"):
                text_piece = chunk.text
            if text_piece:
                collected_text += text_piece
        result = stream_result

    print(f"Agent: {collected_text}\n")
    history = result.all_messages()
What's happening:
  • The agent reads input from the terminal and streams its response
  • Cal API calls happen automatically under the hood
  • The model keeps conversation history to maintain context across turns
9

Run the application

python
if __name__ == "__main__":
    asyncio.run(main())
What's happening:
  • The asyncio loop launches the agent and keeps it running until you exit

Complete Code

Here's the complete code to get you started with Cal and Pydantic AI:

python
import asyncio
import os
from dotenv import load_dotenv
from composio import Composio
from pydantic_ai import Agent
from pydantic_ai.mcp import MCPServerStreamableHTTP

load_dotenv()

async def main():
    api_key = os.getenv("COMPOSIO_API_KEY")
    user_id = os.getenv("USER_ID")
    if not api_key or not user_id:
        raise RuntimeError("Set COMPOSIO_API_KEY and USER_ID in your environment")

    # Create a Composio Tool Router session for Cal
    composio = Composio(api_key=api_key)
    session = composio.create(
        user_id=user_id,
        toolkits=["cal"],
    )
    url = session.mcp.url
    if not url:
        raise ValueError("Composio session did not return an MCP URL")

    # Attach the MCP server to a Pydantic AI Agent
    cal_mcp = MCPServerStreamableHTTP(url, headers={"x-api-key": COMPOSIO_API_KEY})
    agent = Agent(
        "openai:gpt-5",
        toolsets=[cal_mcp],
        instructions=(
            "You are a Cal assistant. Use Cal tools to help users "
            "with their requests. Ask clarifying questions when needed."
        ),
    )

    # Simple REPL with message history
    history = []
    print("Chat started! Type 'exit' or 'quit' to end.\n")
    print("Try asking the agent to help you with Cal.\n")

    while True:
        user_input = input("You: ").strip()
        if user_input.lower() in {"exit", "quit", "bye"}:
            print("\nGoodbye!")
            break
        if not user_input:
            continue

        print("\nAgent is thinking...\n", flush=True)

        async with agent.run_stream(user_input, message_history=history) as stream_result:
            collected_text = ""
            async for chunk in stream_result.stream_output():
                text_piece = None
                if isinstance(chunk, str):
                    text_piece = chunk
                elif hasattr(chunk, "delta") and isinstance(chunk.delta, str):
                    text_piece = chunk.delta
                elif hasattr(chunk, "text"):
                    text_piece = chunk.text
                if text_piece:
                    collected_text += text_piece
            result = stream_result

        print(f"Agent: {collected_text}\n")
        history = result.all_messages()

if __name__ == "__main__":
    asyncio.run(main())

Conclusion

You've built a Pydantic AI agent that can interact with Cal through Composio's Tool Router. With this setup, your agent can perform real Cal actions through natural language. You can extend this further by:
  • Adding other toolkits like Gmail, HubSpot, or Salesforce
  • Building a web-based chat interface around this agent
  • Using multiple MCP endpoints to enable cross-app workflows (for example, Gmail + Cal for workflow automation)
This architecture makes your AI agent "agent-native", able to securely use APIs in a unified, composable way without custom integrations.
TOOLS

Supported Tools

Every Cal action and event your agent gets out of the box.

Add attendee

Creates an attendee for an existing Cal.

Add member to team

Adds a new member to a specified team within an organization by creating a team membership.

Add organization attribute option

Adds a new option to an organization's SINGLE_SELECT or MULTI_SELECT attribute.

Cancel booking via uid

Cancels a Cal.

Check calendar availability

Retrieves free/busy availability for a specified calendar to aid scheduling without revealing event details; requires an existing, accessible calendar, noting that data granularity can vary.

Check gcal synchronization status

Checks the connection and synchronization status of the authenticated user's Google Calendar integration with Cal.

Check ics feed calendar endpoint

Calls the ICS feed check endpoint and returns its status.

Check Stripe status

Verifies if Stripe is correctly connected to the Cal scheduling system and functional for processing payments, reporting only on the integration's status.

Check team stripe integration status

Checks a team's Stripe integration status.

Confirm booking by uid

Confirms an existing booking by `bookingUid` if the booking exists and is in a state allowing confirmation (e.

Connect to calendar

Gets an OAuth authorization URL to connect a specified calendar provider to Cal.

Create membership for organization

Creates a new membership for a user within a Cal.

Create organization attributes

Creates a new custom attribute for an existing organization, used to enhance data collection for event bookings or user profiles.

Create organization team form workflow

Tool to create a new workflow for routing forms within an organization team.

Create organization webhook by org ID

Creates a webhook for an organization that sends HTTP POST notifications to a specified URL when triggered by events (e.

Create or update team profile

Creates a new team profile, or updates one if a 'slug' matches, customizing branding, scheduling, privacy, and operational details.

Create phone call event

Schedules a phone call event in Cal.

Create phone call for event type

Configures Cal.

Create team event type

Creates a new event type for a specified team in Cal.

Create team event types with custom options

Creates a highly customizable Cal.

Create team in organization

Creates a new team with customizable attributes within an existing and accessible Cal.

Create team invite link

Creates a shareable invite link for a Cal.

Create team membership with role

Adds a user to a team with a specified role, acceptance status, and impersonation settings; ensure `teamId` and `userId` refer to existing, valid entities.

Create user availability schedule

Creates a Cal.

Create user schedule in organization

Creates a new schedule defining a user's availability with weekly slots and date-specific overrides in an organization; setting 'isDefault' to true may replace an existing default schedule for the user.

Create webhook for event type

Creates a webhook for an existing `eventTypeId` in Cal.

Decline booking with reason

Declines a pending booking using its bookingUid, optionally with a reason; this action is irreversible and applies only to bookings awaiting confirmation.

Delete all team event type webhooks

Permanently deletes all webhooks associated with a specific team event type.

Delete conference app connection

Disconnects the specified conferencing application (e.

Delete destination calendar by id

Tool to remove an existing destination calendar by its unique ID.

Delete event type by id

Permanently deletes an existing event type by its ID, which invalidates its scheduling links; the operation is irreversible, and while existing bookings are unaffected, no new bookings can be made for this event type.

Delete event type in team

Permanently removes an event type's configuration from a team's scheduling options (e.

Delete membership in team

Use to permanently remove a user's membership from a specific team within an organization, which revokes their team-associated access but does not remove them from the organization.

Delete organization attribute

Permanently deletes an existing attribute (specified by `attributeId`) from an existing organization (specified by `orgId`); this action is irreversible and may affect features dependent on the attribute.

Delete organization attribute option

Permanently deletes a specified option from an organization's attribute.

Delete organization membership

Deletes a user's membership from an organization.

Delete org webhook

Permanently deletes an organization-level webhook by its ID.

Delete schedule by id

Permanently deletes a specific schedule using its unique identifier, which must correspond to an existing schedule.

Delete selected calendars

Removes a specified, currently selected calendar from the user's active list within the application, without deleting it from the external provider.

Delete selected slot

Deletes a reserved time slot using its UID, releasing the reservation.

Delete team by id

Permanently and irreversibly deletes an existing team and all its associated data from the Cal system, using the team's unique `teamId`.

Delete team event type in organization

Permanently removes a team event type from an organization's scheduling configuration.

Delete team from organization

Permanently and irreversibly deletes a specific team from a Cal.

Delete team memberships by id

Irreversibly removes a user's team membership in the Cal application, revoking access to that specific team; the user's overall Cal account remains active.

Delete user attribute option

Unassigns a specific attribute option from a user within an organization.

Delete user from organization

Permanently removes a user from a specific organization (user's system-wide account is unaffected), revoking their access rights therein; this action is irreversible via API and expects the user to be a current member.

Delete user schedule

Permanently deletes a specific user's schedule, provided the organization, user, and schedule (identified by `orgId`, `userId`, and `scheduleId`) exist.

Delete webhook by id

Permanently deletes an existing webhook by its `webhookId`, stopping future notifications; this action is irreversible.

Delete webhook for event type

Permanently deletes a specific webhook for an event type, halting its real-time notifications; this operation is irreversible and leaves the event type and other webhooks untouched.

Delete webhooks for event type

Call this to irreversibly delete all webhooks for a specific `eventTypeId` if the event type exists; details of deleted webhooks are not returned.

Disconnect calendar using credential id

Disconnects a calendar integration by its provider name and credential ID, irreversibly revoking Cal's access; external calendar data remains unaffected.

Edit attendee by ID

Tool to edit an existing attendee in a Cal.

Edit availability by ID

Tool to edit an existing availability by ID on Cal.

Edit booking by ID

Tool to edit an existing booking by its ID.

Edit event type by ID

Tool to edit an existing Cal.

Edit selected calendar by ID

Tool to edit a selected calendar by its composite ID in Cal.

Fetch all bookings

Fetches a list of bookings, optionally filtered by status, attendee, date range, or by event/team IDs (which must belong to/include the authenticated user respectively), with support for pagination and sorting.

Fetch event type details

Fetches all configuration settings and characteristics for a single event type (identified by orgId, teamId, and eventTypeId), which must exist and be accessible; this read-only action cannot list, create, or modify event types.

Fetch organization attribute by id

Retrieves a specific attribute of an organization, useful for fetching a single data point instead of the entire organization record.

Fetch provider access token

Fetches an OAuth access token for the specified `clientId` to authenticate API calls; this action only retrieves the token, not managing scheduling or calendar events.

Fetch schedule by id

Fetches comprehensive details for a specific, existing schedule using its `scheduleId`.

Fetch user schedule by org id

Retrieves a specific user's schedule within an organization, returning availability windows, timezone settings, and date-specific overrides.

Fetch webhook by event type id

Retrieves details for a single, specific webhook using its `webhookId` and associated `eventTypeId`.

Get all timezones

Retrieves Cal.

Get available slots info

Retrieves available time slots for scheduling by considering existing bookings and availability, based on criteria like a specified time range and event type.

Get booking reference by id

Retrieves a booking reference by its ID using the Cal.

Get booking references

Retrieves external references for a specific booking within an organization's team.

Get conference OAuth authorization url

Generates an OAuth 2.

Get default schedule details

Retrieves the authenticated user's default schedule configuration.

Get destination calendars

Retrieves the authenticated user's destination calendar from the calendars response, returning it as a single-item list or an empty list when none is configured.

Get event type by team id

Retrieves a specific event type by its ID, requiring that the event type is associated with the given team ID.

Get event type private links

Retrieves private booking links for a specific event type, including time-limited or usage-limited links.

Get google calendar oauth authentication url

Generates the initial Google Calendar OAuth 2.

Get oauth clients user

Lists managed users associated with a Platform OAuth client, with an optional limit on the number returned.

Get organization attribute assigned options

Retrieves all assigned attribute options for a specific attribute within an organization.

Get organization attribute assigned options by slug

Tool to retrieve all assigned attribute options for a specific attribute by its slug within an organization.

Get organization ID

Retrieves the organization ID associated with the currently authenticated user from the Cal.

Get organization schedules

Retrieves availability schedules for an organization.

Get organization teams event types

Retrieves event types, including names, durations, and custom settings for team scheduling, for all teams within an existing organization specified by `orgId`.

Get organization team workflows

Retrieves workflows configured for a specific team within an organization.

Get organization user schedules

Retrieves all availability schedules configured for a specific user within an organization.

Get private links for team event type

Retrieves private links for a team event type within an organization, including time-based and usage-based links.

Get schedule for user in team

Retrieves all availability schedules for a specific user within a team and organization.

Get selected calendar by ID

Retrieves a selected calendar using its user ID, integration and external ID.

Get stripe connect info

Retrieves a Stripe Connect authorization URL for connecting the user's Stripe account to Cal.

Get Stripe Connect URL for team

Tool to get Stripe Connect authorization URL for a team within an organization.

Get team bookings

Retrieves bookings for a specified team, with optional filters, pagination and sorting.

Get team default conferencing app

Retrieves the default conferencing application configured for a specific team within an organization.

Get team details by organization ID and team ID

Retrieves comprehensive details for a specific team within an organization, including team metadata, configuration settings, branding options, and timezone/week preferences.

Get team event type webhook

Retrieves details for a specific webhook configured on a team event type.

Get team event type webhooks

Retrieves webhooks configured for a specific team event type, with optional pagination using take and skip.

Get team information by team ID

Retrieves detailed information about a specific Cal.

Get team routing forms

Retrieves routing forms for a specific team within an organization.

Get team schedules

Retrieves availability schedules for all members of a specific team within an organization.

Get teams list

Retrieves teams the user belongs to, including their names and team details.

Get verified phone numbers

Retrieves a paginated list of verified phone numbers for a specific organization team.

Get webhook by id

Retrieves details for an existing and accessible webhook by its ID; this is a read-only operation.

Handle conferencing oauth callback for app

Processes an OAuth 2.

List all attendees

Retrieves attendees across bookings using the Cal.

List booking references

Fetches one page of bookings and extracts their references, with caller-driven cursor pagination.

List event types

Retrieves Cal event types, filterable by `username` (required if `eventSlug` is provided), multiple `usernames`, or organization details (`orgSlug` or `orgId`).

List organization memberships

Retrieves organization memberships with user details, roles, acceptance status, and custom attributes.

List team event types by org and team id

Retrieves all event types for a specific team within an organization, optionally filtering by a specific event slug.

Mark booking absent for UID

Marks the host and/or specified attendees as absent for an existing booking, typically used after a scheduled event to record no-shows.

Modify organization membership by id

Updates an organization membership's status (accepted), role, or impersonation settings, identified by `orgId` and `membershipId` in the path; requires at least one of these fields in the request to apply changes.

Modify org attribute by id

Partially updates an organization attribute using `orgId` and `attributeId`, allowing modification of its name, slug, type, or enabled status; changing the 'type' may affect existing data.

Patch organization attribute option

Partially updates a specific option for an organization's attribute, modifying its 'value' and/or 'slug'; at least one of 'value' or 'slug' must be provided.

Patch organization user details

Partially updates details for a user that exists within the specified organization.

Patch team details by ID

Updates specified details for an existing team identified by `teamId`; unspecified fields remain unchanged.

Patch webhook event type

Updates configuration (e.

Post calendar credentials

Use to submit/update authentication credentials (passed in the request body) for an existing calendar, enabling Cal to connect with external calendar services for synchronization.

Connect conferencing app

Connects Google Meet to Cal.

Create a new booking

Creates a booking for an event type at a specified start time.

Assign or create attribute option for user

Assigns an existing attribute option (using `attributeOptionId`) or creates a new one (using `value`) for a user, linking it to a specified `attributeId` which must already exist within the organization.

Add selected calendar

Links a new external calendar or updates an existing link to one, enabling synchronization with the Cal application by specifying the `integration` provider, the calendar's `externalId`, and the `credentialId`.

Post user to organization

Adds a new user to an existing organization (identified by `orgId` in path), requiring user's `email` and allowing extensive optional profile customization.

Create webhook subscription

Creates a new Cal.

Reassign booking to another user

Reassigns the host of a round-robin booking to a specified user.

Reassign booking with uid

Reassigns the host of a round-robin or managed event type booking by UID.

Request email verification code

Request an email verification code for a team's verified resources.

Reschedule booking by uid

Reschedules an existing booking (identified by `bookingUid`) to a new time.

Reserve slot for event

Temporarily reserves an available time slot for an existing and bookable event type, useful for high-demand slots to prevent double-bookings while the user completes the booking.

Retrieve attribute options for org

Retrieves all available options for a specific attribute within an organization.

Retrieve booking details by uid

Fetches comprehensive details for an existing booking, identified by its `bookingUid`.

Retrieve calendar busy times

To find busy calendar slots for scheduling/conflict detection, call this with a valid `credentialId`, an `externalId` accessible by it, and a recognized IANA `loggedInUsersTz`; returns only busy intervals, not event details or free slots.

Retrieve calendar list

Retrieves a list of all calendar summaries (no event details) associated with the authenticated user's account.

Retrieve current team for organization

Retrieves details of the team(s) for the currently authenticated user within the specified organization `orgId`.

Retrieve default conferencing settings

Retrieves the authenticated user's default conferencing application settings, including its app identifier and link when available.

Retrieve event type by id

Retrieves comprehensive details for a specific, existing Cal.

Retrieve membership from organization

Retrieves detailed information about a specific membership within a particular organization.

Retrieve my information

Retrieves the authenticated user's core profile information (e.

Retrieve OAuth client user by ID

Retrieves detailed profile information for a specific managed user associated with an OAuth client.

Retrieve organization attributes

Retrieves custom attribute definitions for an organization, with optional pagination.

Retrieve organization attributes options

Retrieves all attribute options assigned to a specific user within an organization.

Retrieve organization webhook by id

Retrieves detailed information, including configuration and status, for a specific webhook by its ID (`webhookId`) within a given organization (`orgId`).

Retrieve organization webhooks by org ID

Retrieves all webhooks configured for a specific organization, returning an array of webhook objects with their configuration details (ID, triggers, subscriber URL, active status, etc.

Retrieve provider details

Verifies and retrieves details for an OAuth client (provider) in Cal.

Retrieve schedules list

Retrieve all availability schedules for the authenticated Cal.

Retrieve team details in organization

Retrieves a paginated list of teams and their details for a specified organization.

Retrieve team event types

Retrieves event types for a team within the Cal scheduling system; this action does not provide details on scheduled instances or member availability.

Retrieve team membership by id

Retrieves detailed information for a specific team membership by its ID within an organization's team.

Retrieve team membership details

Retrieves detailed attributes for a specific team membership by its ID and the team ID, such as member information, role, and status; does not list all team members.

Retrieve team memberships

Retrieves team memberships, including roles and invitation acceptance status, with optional member details and pagination via take and skip.

Retrieve team memberships for organization

Retrieves all user memberships for a specific team within an organization, including each member's role (OWNER, ADMIN, MEMBER), acceptance status, impersonation settings, and detailed user information (email, username, name, avatar, bio).

Retrieve users in organization

Retrieves users associated with a specific organization ID, with optional pagination and email filtering.

Retrieve v2 conferencing info

Lists the authenticated user's installed conferencing applications and their connection status.

Retrieve webhook details for OAuth client

Retrieves a paginated list of webhook configurations for a specific OAuth client through Cal.

Retrieve webhooks for event type

Retrieves a paginated list of webhooks (including URLs, subscribed events, and status) for a specified, existing event type ID, useful for auditing configurations or troubleshooting.

Retrieve webhooks list

Retrieves a paginated list of webhooks from the user's Cal scheduling system account, which are used for real-time notifications on events like new bookings, cancellations, or updates.

Save calendar entry

Saves Google or Outlook calendar credentials using an authorization code and state for the selected calendar provider.

Save calendar ics feeds

Imports and saves one or more publicly accessible external iCalendar (ICS) feed URLs into the Cal.

Save OAuth credentials via GCal API

Completes the Google Calendar OAuth 2.

Save stripe details

Completes the Stripe OAuth flow by saving Stripe details; call this when a user is redirected back from Stripe with an authorization `code` and `state`.

Set default conferencing app

Sets the specified, valid, and configured conferencing application as the default for new meetings for the authenticated user.

Update destination calendar integration

Updates the destination calendar for syncing events, using `integration` and `externalId` (typically from `/calendars` endpoint).

Update OAuth client user settings

Updates specified profile and scheduling preference fields for a user associated with an OAuth client; `defaultScheduleId`, if provided, must be an existing, valid schedule for the user.

Update oauth client webhook

Updates specified properties of an existing webhook for an OAuth client; omitted fields remain unchanged.

Update private link

Updates a private link for a team event type within an organization.

Update schedule by ID

Updates an existing schedule by its ID, allowing partial modification of properties; providing `availability` or `overrides` replaces them entirely.

Update team event type

Tool to update a team event type in Cal.

Update team event type webhook

Updates a webhook for a team event type.

Update team information by id

Updates an existing team's information by its ID within a specified organization; the `slug`, if provided, must be unique within the organization.

Update team membership by id

Updates properties of an existing team membership.

Update team membership properties

Updates attributes like acceptance status, role, or impersonation settings for an existing team membership within an organization.

Update user profile details

Updates the authenticated user's profile information and preferences using the provided fields.

Update user schedule in organization

Modifies an existing schedule for a specified user within an organization by updating only the provided fields; the organization, user, and schedule must already exist.

Update webhook by id

Updates an existing Cal.

Update webhook for organization

Updates an existing webhook for an organization.

FRAMEWORKS

How to build Cal MCP Agent with another framework

Claude Code logo

Claude Code

Use Cal MCP with Claude Code

Claude Cowork logo

Claude Cowork

Use Cal MCP with Claude Cowork

OpenAI Agents SDK logo

OpenAI Agents SDK

Use Cal MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use Cal MCP with Claude Agent SDK

Muse logo

Muse

Use Cal MCP with Muse

Codex logo

Codex

Use Cal MCP with Codex

OpenClaw logo

OpenClaw

Use Cal MCP with OpenClaw

Hermes logo

Hermes

Use Cal MCP with Hermes

Atomic Agent logo

Atomic Agent

Use Cal MCP with Atomic Agent

Google ADK logo

Google ADK

Use Cal MCP with Google ADK

LangChain logo

LangChain

Use Cal MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use Cal MCP with Vercel AI SDK

Mastra AI logo

Mastra AI

Use Cal MCP with Mastra AI

LlamaIndex logo

LlamaIndex

Use Cal MCP with LlamaIndex

CrewAI logo

CrewAI

Use Cal MCP with CrewAI

AutoGen logo

AutoGen

Use Cal MCP with AutoGen

FAQ

Frequently asked questions

With a standalone Cal MCP server, the agents and LLMs can only access a fixed set of Cal tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Cal and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Pydantic AI fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Cal tools.

Yes, absolutely. You can configure which Cal scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Cal data and credentials are handled as safely as possible.

Start with Cal.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Cal tool your agent needs.Free to start.

Start building