How to Use the Calenso MCP in CrewAI

Q: How do I configure Calenso tools for a CrewAI agent?

Install the framework with pip install crewai 'crewaitools'. Then, simply pass your MCP server URL directly into the agent's mcps parameter, and the framework will load the tools automatically.

Deploy specialized CrewAI agent teams to manage your Calenso appointments and customer records autonomously.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Calenso MCP to CrewAI

Create your Vinkius account to connect Calenso to CrewAI 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 Calenso with CrewAI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Coordinate team schedules across agents

Run `list_calenso_appointments` to let your coordination agent audit the master schedule for conflicts. This tool gives your CrewAI team a full view of booked time slots so they can resolve scheduling overlaps. You can assign one agent to analyze the calendar while a separate moderator agent uses the data to reschedule conflicting slots. This cooperative setup keeps your calendar organized without you having to step in.

Audit bookings with this CrewAI MCP Server

Use `get_calenso_appointment` to inspect specific booking details, including custom fields and customer notes. This tool lets your research agent pull deep context on a single meeting before handing it off to the customer service agent. CrewAI's shared memory allows all agents in the crew to remember these appointment details during a run. The agent can quickly check the notes, verify the staff assignment, and draft a personalized reminder email.

Onboard customers with multi-agent consensus

Execute `create_calenso_customer` to add new leads to your booking database after an agent team verifies their info. This tool registers the client details once your validation agent confirms the email and phone number are correct. By passing the MCP URL into your crew's `mcps` array, every CrewAI agent gains access to this Calenso registration capability. The crew can work sequentially, making sure the profile is created before any slots are reserved.

Setup guide

Set up Calenso MCP in CrewAI

Prerequisites

Python 3.10+ installed
crewai package (pip install crewai)
Active Vinkius subscription with a valid endpoint token

1

Install CrewAI
Run pip install crewai to install the framework. MCP support is built-in via the mcps parameter.
2

Add the MCP URL to your agent
Pass your Vinkius endpoint directly to the mcps list. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. CrewAI handles tool discovery and caching automatically.
3

Kick off your crew
Create a Crew with your agent and tasks. Call crew.kickoff() — the agent will automatically invoke Calenso tools as needed.

crew.py

from crewai import Agent, Task, Crew

agent = Agent(
    role="Calenso Analyst",
    goal="Access and analyze Calenso data via MCP.",
    backstory="Expert analyst with direct Calenso access.",
    mcps=[
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ],
)

task = Task(
    description="List recent Calenso transactions",
    agent=agent,
    expected_output="A summary of recent activity",
)

crew = Crew(agents=[agent], tasks=[task])
result = crew.kickoff()
print(result)

Get your connection token →

Prerequisites

Python 3.10+ installed
crewai + crewai-tools packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install crewai crewai-tools. The MCPServerAdapter handles lifecycle management and tool conversion.
2

Connect with MCPServerAdapter
Use MCPServerAdapter as a context manager with SseServerParameters pointing to your Vinkius endpoint. The adapter automatically manages connection lifecycle.
3

Assign tools and run
Pass the returned mcp_tools to your agent's tools parameter. The adapter converts MCP tools to native BaseTool objects compatible with all CrewAI agents.

crew.py

from crewai import Agent, Task, Crew
from crewai_tools import MCPServerAdapter
from mcp import SseServerParameters

server_params = SseServerParameters(
    url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)

with MCPServerAdapter(server_params) as mcp_tools:
    agent = Agent(
        role="Calenso Analyst",
        goal="Access and analyze Calenso data via MCP.",
        backstory="Expert analyst with direct Calenso access.",
        tools=mcp_tools,
    )

    task = Task(
        description="List recent Calenso transactions",
        agent=agent,
        expected_output="A summary of recent activity",
    )

    crew = Crew(agents=[agent], tasks=[task])
    result = crew.kickoff()
    print(result)

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 Calenso. 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 Calenso 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 Calenso MCP in CrewAI

Install the framework with pip install crewai 'crewai[tools]'. Then, simply pass your MCP server URL directly into the agent's mcps parameter, and the framework will load the tools automatically.

Yes. Use the MCP server class from crewai.mcp and apply a tool_filter. This lets you restrict sensitive tools like cancel_calenso_appointment to supervisor agents only.

Yes. You can design a hierarchical crew where an intake agent first runs list_calenso_services, and a booking agent then schedules the appointment based on those options.

The MCP Server supports stdio, SSE, and Streamable HTTP. CrewAI connects to the Vinkius hosting environment using standard web protocols, ensuring stable communication during long-running agent loops.

Your customer records and phone numbers are protected by Vinkius's zero-trust V8 isolate architecture. The data fetched via list_calenso_customers is processed in memory during the agent execution and is never stored or logged on the Vinkius platform.

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