SavvyCal (BYOK) — connector documentation
- MCP endpoint:
https://byok-savvycal.connectorbay.com/mcp - REST API:
POST https://byok-savvycal.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec athttps://byok-savvycal.connectorbay.com/openapi.json - Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
- Authentication: your own SavvyCal personal access token (starts with pt_secret_), sent in the
X-Upstream-Keyheader of every request (never stored, logged or cached) - Health:
https://byok-savvycal.connectorbay.com/health· Tool schemas:https://byok-savvycal.connectorbay.com/tools.json - Publisher: Unify Dynamics LLC · connectorbay.com/byok-savvycal · agent@connectorbay.com
What SavvyCal (BYOK) is for
SavvyCal (BYOK) lets an AI assistant read your own SavvyCal data through the SavvyCal API with a key you supply (personal access token (starts with pt_secret_)). Read-only: 8 tools (get_current_user, list_events, get_event, list_links, get_link, list_link_slots, list_workflows, list_time_zones). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever sent to api.savvycal.com. Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by SavvyCal. SavvyCal and its logos are trademarks of their owners and are used only to say which service the connector works with.
Ask your assistant things like:
- "Which SavvyCal account is my token connected to?"
- "What meetings do I have coming up in SavvyCal?"
- "Show SavvyCal event event_01KKGY70MFPCECSQ6KM6FMDPC3."
- "Which scheduling links do I have in SavvyCal?"
- "Show SavvyCal scheduling link link_01J5KC2G3MHPCECSQ6KM6FMDPC."
- "When is my SavvyCal link link_01J5KC2G3MHPCECSQ6KM6FMDPC bookable this week?"
What it does
get_current_user: Show the SavvyCal user the token belongs to: name, email, plan, time zone and time format.list_events: List booked meetings with title, start and end, state, link, organizer, attendees and join details. Defaults to your upcoming confirmed meetings; filter by state, period, dates or link. Pages by cursor.get_event: Get one booked meeting by event id or UUID with title, times, state, attendees, location, conferencing, payment and cancel or reschedule details.list_links: List scheduling links with name, slug, state, durations, increment, custom fields and owning scope. Filter by active or disabled. Pages by cursor.get_link: Get one scheduling link by id with name, slug, state, durations, increment, custom fields and scope.list_link_slots: List open time slots on a scheduling link with start, end, duration and rank. The window can span at most 31 days.list_workflows: List automated workflows with name, state and creation date. Pages by cursor.list_time_zones: List time zones with id, abbreviation, offset, daylight-saving flag and names, as of now or a chosen instant. Large answer, capped.
BYOK key
You bring your own SavvyCal personal access token (starts with pt_secret_) (https://savvycal.com/developers). Your assistant sends it in the X-Upstream-Key header with each request. ConnectorBay uses it for that one call only: it is never stored, logged or cached, never shown in an answer, and it is only sent to api.savvycal.com over https, with no redirects followed. Create a key with the fewest permissions the tools need (read-only if the provider offers it), and revoke it at the provider whenever you like.
Data sources
- https://developers.savvycal.com/category/rest-api (the API this connector calls, with a BYOK key)
Live from the SavvyCal API (api.savvycal.com) with a BYOK key; documentation: https://developers.savvycal.com/category/rest-api. Endpoints checked against that documentation on 2026-10-16.
What it is not
Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by SavvyCal. SavvyCal and its logos are trademarks of their owners and are used only to say which service the connector works with. It is read-only: it never creates, changes, sends or deletes anything in your SavvyCal account.
Built for: Worldwide. Languages: English.