Documentation

Everything you need to integrate Temporal Cortex into your AI agent workflow.

Quick Start

Get your AI agent scheduling meetings in under 2 minutes.

1

Install

Install the MCP server binary via npm. No signup required.

npx @temporal-cortex/cortex-mcp
2

Authenticate

Connect your calendar provider via OAuth.

npx @temporal-cortex/cortex-mcp auth google
3

Configure your AI agent

Add Temporal Cortex to your agent's MCP configuration. See agent configuration below for copy-pasteable JSON.

4

Start scheduling

Your agent now has access to 11 tools across 4 layers. See the tool reference for the full list.

Tool Reference

11 MCP tools organized in 4 layers. Each layer builds on the one below it.

Layer 1

Temporal Context

Time awareness, datetime resolution, and computation. The foundation for all calendar operations.

get_temporal_context Returns current time, timezone, day of week, and week/month boundaries.
resolve_datetime Converts natural language expressions like "next Tuesday at 3pm" to ISO 8601 timestamps.
convert_timezone Converts a timestamp between IANA timezones.
compute_duration Calculates the duration between two timestamps in human-readable units.
adjust_timestamp Adds or subtracts time from a timestamp (e.g., "+2 hours", "-30 minutes").
Layer 2

Calendar Operations

Direct calendar data access, free slot computation, and recurrence rule expansion.

list_events Lists calendar events within a date range, expanding recurring events.
find_free_slots Finds available time slots on a given date within working hours.
check_availability Checks whether a specific time slot is free or busy on a calendar.
expand_rrule Expands an iCalendar RRULE into individual occurrence timestamps.
Layer 3

Availability

Cross-calendar availability merging into a unified free/busy view.

get_availability Merges availability across all connected calendar providers into a single free/busy timeline.
Layer 4

Booking

Atomic event creation with Two-Phase Commit to prevent double-booking.

book_slot Books a calendar event atomically — acquires lock, verifies no conflicts, writes event, releases lock.

Agent Configuration

Copy-paste the configuration for your AI agent or editor.

Claude Desktop

claude_desktop_config.json

{
  "mcpServers": {
    "temporal-cortex": {
      "command": "npx",
      "args": ["@temporal-cortex/cortex-mcp"]
    }
  }
}

VS Code / Cursor / Windsurf

.vscode/mcp.json

{
  "servers": {
    "temporal-cortex": {
      "command": "npx",
      "args": ["@temporal-cortex/cortex-mcp"]
    }
  }
}

Zed

settings.json

{
  "context_servers": {
    "temporal-cortex": {
      "command": {
        "path": "npx",
        "args": ["@temporal-cortex/cortex-mcp"]
      }
    }
  }
}

Generic MCP

mcp.json

{
  "mcpServers": {
    "temporal-cortex": {
      "command": "npx",
      "args": ["@temporal-cortex/cortex-mcp"],
      "transportType": "stdio"
    }
  }
}

Calendar Providers

Temporal Cortex connects to all major calendar providers. Manage multiple calendars from a single MCP server.

Google Calendar

OAuth 2.0 authentication. Personal and Google Workspace accounts.

Microsoft Outlook / Exchange

OAuth 2.0 via Microsoft Graph API. Personal and Microsoft 365 accounts.

CalDAV

Apple iCloud, Fastmail, Nextcloud, and any CalDAV-compatible server.

Resources

Source code, package registries, and community.

GH

temporal-cortex-mcp

Documentation, configs, and issue tracker

 GH

temporal-cortex-core

Rust core — TOON encoder + Truth Engine

 GH

temporal-cortex-skill

Agent Skill for the 4-step scheduling workflow

 npm

@temporal-cortex/cortex-mcp

MCP server binary on npm

 SM

Smithery

temporal-cortex/cortex-mcp on Smithery registry

 MCP

MCP Registry

Official MCP Registry listing