How to Connect Codex to Novacal MCP
Add Novacal as a Codex MCP server to check availability, manage event types, and schedule meetings from Codex using the hosted Novacal MCP server.
Novacal×CodexBefore you start
What you need
Make sure you have these ready before connecting Novacal to Codex.
- 1. A Novacal account — sign up at novacal.io if you don't have one yet
- 2. A Novacal API key — generate one from account settings, you'll paste it during the OAuth step
- 3. Codex installed on your computer
- 4. The Novacal MCP server URL
https://mcp.novacal.io/mcp
Setup
How to connect Novacal with Codex
With the Novacal MCP server for Codex, you can manage meetings and availability right from Codex using the hosted Novacal MCP server.
- 1. Open a terminal on the machine where you use Codex
- 2. Add Novacal as a streamable HTTP MCP server with
codex mcp add novacal --url https://mcp.novacal.io/mcp - 3. Start the OAuth connection with
codex mcp login novacal - 4. Approve access in the browser window Codex opens
- 5. Paste your Novacal API key when prompted
config.tomlCodex configuration
[mcp_servers.novacal]
url = "https://mcp.novacal.io/mcp"The recommended setup is the Codex CLI command codex mcp add novacal --url https://mcp.novacal.io/mcp.
Codex stores this server in ~/.codex/config.toml.
FAQ
Frequently Asked Questions
Common questions about connecting Codex to the Novacal MCP server.
Yes. Codex connects to the Novacal MCP server through OAuth, and Novacal uses your API key to authorize scheduling actions for your account.