Skip to main content

​
Hosted endpoint

Use the hosted Novacal MCP server at: 
https://mcp.novacal.io/mcp
The server uses Streamable HTTP and is intended for MCP-compatible clients.

​
Authentication

The MCP server uses OAuth for the MCP connection. During the first connection, you will be sent to a Novacal authorize page. On that page, enter your Novacal API key from: https://app.novacal.io/settings/api-keys The MCP server verifies the key with the Novacal API, stores it, and then uses it for future tool calls on your behalf.

​
Set up in Claude

To connect Novacal in Claude:
  1. Open Claude and add a new custom connector.
  2. Enter the MCP server URL:
https://mcp.novacal.io/mcp
  1. Choose OAuth as the authentication method.
  2. Leave Client ID and Client Secret empty.
  3. Continue the OAuth flow.
  4. When the Novacal authorize page opens, paste your Novacal API key.
  5. Finish the connection.

​
Available tools

The current MVP toolset includes:
  • get_event_types
  • get_event_type
  • create_event_type
  • get_availability
  • get_events
  • create_event

​
Example prompts

  • Show my Novacal event types.
  • Show my Novacal event types and include their IDs.
  • Get my upcoming Novacal events.
  • Check my availability for event type 123 from 2026-06-01 to 2026-06-07.
  • Create a new one-on-one event type named Intro Call, 30 minutes long, hidden from profile, with color #2563EB.

​
Notes

  • Each user should use their own Novacal API key.
  • If the saved API key is revoked or becomes invalid, reconnect and authorize again.