How to Use the Clockwise MCP in CrewAI

Q: How do I configure Clockwise with CrewAI?

Install the framework with pip install crewai "crewaitools". Pass your Vinkius endpoint directly into the mcps array on your Agent definition. The crew will automatically discover and load all ten scheduling tools.

Q: Can a CrewAI agent update Clockwise preferences?

Yes, an agent can use updatepreferences to provision a highly-available override payload. You should assign this specific tool to an execution agent using MCPServerHTTP and a toolfilter. That keeps your researcher agents from making unauthorized changes.

Q: How does CrewAI share Clockwise data between agents?

When the first agent pulls meeting metadata histories via getmeetinganalytics, it stores the active arrays in shared memory. The next agent in the hierarchy reads that context instantly. They collaborate without needing to fetch the data twice.

Deploy autonomous scheduling crews in Python using CrewAI and the Clockwise MCP integration.

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 CrewAI

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

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Audit organizational focus time autonomously

`get_focus_time` performs structural extraction of properties driving active deep work limits for your CrewAI researcher agent. You assign one agent to solely monitor calendar health across the engineering department. It continuously pulls these boundaries into shared memory. An analyst agent then takes over, running `get_time_insights` to resolve AI-nested focus analytics. The crew works sequentially to build a complete picture of developer productivity. No human manager needs to pull a single report.

Manage meeting conflicts with an MCP Server

`get_calendar_events` identifies bounded logical arrays managing top-level calendar blocks for your moderator agent. When a schedule conflict arises, the crew detects the overlap. It evaluates the priority of competing meetings automatically. The execution agent then fires `toggle_autopilot` to mutate explicit boundaries, shifting intelligent meeting moving on or off as needed. CrewAI handles the tool execution through its native HTTP transport wrapper. The crew resolves the collision before anyone notices.

Coordinate team availability dynamically

`get_team_availability` identifies explicit cloud calculations tracking absolute team free times. Your scheduling agent uses this to find the exact right moment for an all-hands sync. It reads the shared memory context to avoid pinging individuals. If someone's settings block the proposed time, the crew can trigger `get_preferences`. It retrieves the exact structural matching verifying explicit user settings. The agents adapt their booking strategy based on these hard constraints.

Setup guide

Set up Clockwise 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 Clockwise tools as needed.

crew.py

from crewai import Agent, Task, Crew

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

task = Task(
    description="List recent Clockwise 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="Clockwise Analyst",
        goal="Access and analyze Clockwise data via MCP.",
        backstory="Expert analyst with direct Clockwise access.",
        tools=mcp_tools,
    )

    task = Task(
        description="List recent Clockwise 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 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 CrewAI

Install the framework with `pip install crewai "crewai[tools]"`. Pass your Vinkius endpoint directly into the `mcps` array on your Agent definition. The crew will automatically discover and load all ten scheduling tools.

Yes, an agent can use `update_preferences` to provision a highly-available override payload. You should assign this specific tool to an execution agent using `MCPServerHTTP` and a `tool_filter`. That keeps your researcher agents from making unauthorized changes.

When the first agent pulls meeting metadata histories via `get_meeting_analytics`, it stores the active arrays in shared memory. The next agent in the hierarchy reads that context instantly. They collaborate without needing to fetch the data twice.

The Python implementation supports stdio, SSE, and Streamable HTTP transports. Vinkius endpoints work perfectly with the HTTP transport for remote execution.

We run your MCP server in a strictly ephemeral V8 Isolate. When your Python crew fetches bounded logical arrays of calendar blocks, the sandbox executes and immediately terminates. Vinkius never inspects or logs your internal structural state mappings.

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