What You'll Set Up
By the end of this guide, your AI agent will be able to interact with your Calendly account — listing upcoming events, checking your availability, creating scheduling links, and managing invitees. Everything runs through a secure connection between Pipeworks and Calendly, and the setup takes about five minutes.
Once connected, your agent can answer questions like "What meetings do I have tomorrow?" or "Create a 30-minute scheduling link for client consultations" without you lifting a finger.
Before You Begin
Make sure you have:
- A Calendly account — Sign up for free if you don't have one
- A Pipeworks workspace — Sign up at pipeworks.ai if you haven't already
Calendly's free plan works for basic scheduling. Some advanced features like activity logs require an Enterprise plan, and creating event invitees requires a paid plan.
Steps
Get your Personal Access Token
Log into your Calendly account and click on Integrations in the left sidebar. Scroll down to the Personal Access Tokens section and click Generate New Token.
Give the token a descriptive name like "Pipeworks" and click Create Token. Copy the token immediately — Calendly only shows it once. It will start with eyJraW.
Open your Pipeworks console
Log into your Pipeworks workspace and go to the Integrations page. Find Calendly in the list and click on it.
Enter your credentials
Paste your Calendly Personal Access Token into the Personal Access Token field and click Connect.
Pipeworks encrypts your token with AES-256-GCM before storing it. The plaintext is never saved to disk and is only decrypted when your integration container starts.
Start the integration
Click Start to launch the Calendly integration container. This takes a few seconds. Once the status shows Running, your agent is ready to use Calendly tools.
Test the connection
Use the Test button to verify everything works. This sends a simple request to Calendly to confirm your token is valid and your account is accessible.
What Your Agent Can Do
Once connected, your AI agent has access to Calendly tools for:
- Events — List scheduled events, get event details, view upcoming and past meetings
- Availability — Check your available time slots and scheduling windows
- Scheduling links — Create and manage event type links for different meeting formats
- Invitees — View who has booked meetings, manage invitee details, and cancel bookings
- Event types — List your event types and their configurations
Use tool profiles to control what your agent can do. Set the profile to read-only if you only want your agent to check your schedule without making any changes.
Connecting from Your AI Agent
Add the Pipeworks tools endpoint to your agent's configuration. Here's an example for Claude Desktop:
{
"mcpServers": {
"pipeworks-calendly": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://app.pipeworks.ai/tools/calendly"]
}
}
}
Claude Desktop will prompt you to sign in through Pipeworks when you first connect. No access key needed.
Troubleshooting
Connection test fails? Make sure you copied the full Personal Access Token from Calendly. Tokens start with eyJraW and are quite long — double-check that you didn't cut it short.
Token expired or revoked? If your Calendly token stops working, generate a new one from Calendly's Integrations page and update it in your Pipeworks console by clicking Disconnect and reconnecting with the new token.
Container won't start? Make sure your integration is enabled. An admin needs to assign the Calendly integration to your workspace first.
Agent can't find tools? Verify your Pipeworks session is authenticated and that the integration status shows "Running" in your Pipeworks console.