# Temporal Cortex MCP

Temporal Cortex is a Model Context Protocol server that gives AI agents deterministic calendar capabilities — temporal context, datetime resolution, multi-calendar availability merging across Google …

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add temporal-cortex/cortex-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list temporal-cortex/cortex-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get temporal-cortex/cortex-mcp get_temporal_context

# Call a tool
npx -y @smithery/cli@latest tool call temporal-cortex/cortex-mcp get_temporal_context '{}'
```

## Direct MCP Connection

Endpoint: `https://cortex-mcp--temporal-cortex.run.tools`

## Tools (12)

- `get_temporal_context` — Get the current temporal context — time, timezone, calendar metadata. Call this first to orient yourself in time before…
- `resolve_datetime` — Resolve a human-readable time expression to an absolute datetime. Supports: 'next Tuesday at 2pm', 'tomorrow morning', …
- `convert_timezone` — Convert a datetime to a different timezone.
- `compute_duration` — Compute the duration between two timestamps. Returns days, hours, minutes, seconds, and a human-readable string.
- `adjust_timestamp` — Adjust a timestamp by adding or subtracting a duration. DST-aware: '+1d' preserves wall-clock time across daylight savi…
- `list_calendars` — List all connected calendars across providers. Returns calendar IDs, names, labels, and metadata.
- `list_events` — List calendar events in a time range. Returns events in TOON or JSON format.
- `find_free_slots` — Find available free time slots in a calendar within a time window.
- `expand_rrule` — Expand a recurrence rule (RRULE) into concrete event instances.
- `check_availability` — Check if a calendar time slot is available (not held by another booking).
- `get_availability` — Get unified availability across multiple calendars. Merges events from all specified calendars into a single busy/free …
- `book_slot` — Book a calendar slot using Two-Phase Commit for safe, conflict-free booking.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get temporal-cortex/cortex-mcp <tool-name>
```