How to connect Calendly to Codex

1. 1. Enable Calendly in Metorial

   In your Metorial portal, enable the Calendly MCP server and sign in with the account that owns the data. Access stays governed by your team policies.

2. 2. Add the server and sign in

   The Codex CLI, IDE extension and ChatGPT desktop app share this config.

   Copy

   codex mcp add metorial --url <your-magic-mcp-url>
   codex mcp login metorial

3. 3. Check the connection

   Type /mcp in Codex to see Metorial and its Calendly tools.

• Create Scheduling Link: Create a single-use scheduling link for a specific event type.
• Cancel Event: Cancel a scheduled Calendly event.
• Get Event Details: Retrieve detailed information about a specific scheduled event, including its invitees.
• Check Availability: Check available time slots for a specific event type, retrieve a user's busy times, or list availability schedules.
• Get User: Retrieve a Calendly user's profile information.
• List Scheduled Events: List scheduled events (meetings) for a user or organization.
• List Event Types: List event type templates (e.g., "30-min Demo", "Onboarding Call") for a user or organization.
• Mark Invitee No-Show: Mark or unmark an invitee as a no-show for a scheduled event.
• List Routing Forms: List routing forms and optionally their submissions for an organization.
• List Organization Members: List all members of a Calendly organization.
• List Event Invitees: List invitees for a scheduled event.
• Create Event Invitee: Book a Calendly meeting by creating an invitee for an event type at an available start time.
• Get Event Type: Retrieve detailed Calendly event type configuration, including scheduling URL, duration, location metadata, and custom questions.
• Get Event Invitee: Retrieve detailed invitee information for a scheduled event, including contact details, answers, no-show status, and cancellation/reschedule links.

• Limit which Calendly tools Codex sees with enabled_tools and disabled_tools on the metorial server in config.toml.
• Set default_tools_approval_mode to auto, prompt, writes or approve. writes prompts only for tools that are not marked read-only.
• Type /mcp in the composer to see the connected servers.
• Override the approval behavior for a single Calendly tool with tools.<tool>.approval_mode.

Metorial is listed but tools are missing

Codex can connect without credentials and then see nothing. Run codex mcp login metorial to complete the OAuth sign-in.

Metorial times out at startup

Codex waits 10 seconds by default. Raise startup_timeout_sec under [mcp_servers.metorial] in ~/.codex/config.toml.

Long tool calls fail after a minute

The default tool timeout is 60 seconds. Raise tool_timeout_sec for the metorial server in config.toml.

Based on the Codex MCP documentation.