> ## Documentation Index
> Fetch the complete documentation index at: https://docs.novacal.io/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP

> Connect Novacal to MCP-compatible clients using the hosted Novacal MCP server, enabling authenticated integration between Novacal and supported AI tools through a remote MCP endpoint.

## Hosted endpoint

Use the hosted Novacal MCP server at:

```txt theme={null}
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](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:

```txt theme={null}
https://mcp.novacal.io/mcp
```

3. Choose `OAuth` as the authentication method.
4. Leave `Client ID` and `Client Secret` empty.
5. Continue the OAuth flow.
6. When the Novacal authorize page opens, paste your Novacal API key.
7. 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`
* `cancel_event`
* `reschedule_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.`
* `Cancel Novacal event 456 because the attendee requested to reschedule.`
* `Reschedule Novacal event 456 to June 2, 2026 at 14:00 Europe/Belgrade.`

## Notes

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