io.github.billylui/temporal-cortex-mcp

Official

Temporal Cortex Calendar MCP

12 deterministic calendar tools — temporal context, scheduling, availability, and booking

Calendar tools for temporal context, scheduling, availability, and booking.

Install

Configuration

Environment variables

GOOGLE_CLIENT_ID

Google OAuth Client ID (required for Google Calendar)

GOOGLE_CLIENT_SECRETsecret

Google OAuth Client Secret (required if using Google Calendar)

GOOGLE_OAUTH_CREDENTIALS

Path to Google OAuth JSON credentials file (alternative to CLIENT_ID + SECRET)

MICROSOFT_CLIENT_ID

Azure AD app ID (required for Outlook Calendar)

MICROSOFT_CLIENT_SECRETsecret

Azure AD client secret (required for Outlook Calendar)

TIMEZONE

IANA timezone override (e.g., America/New_York). Overrides stored config and OS detection.

WEEK_STARTdefault monday

Week start day: 'monday' (default, ISO 8601) or 'sunday'. Overrides stored config.

TENANT_ID

UUID for tenant isolation (auto-generated if not set)

LOCK_TTL_SECSdefault 30

Lock time-to-live in seconds for booking safety

OAUTH_REDIRECT_PORTdefault 8085

Port for the local OAuth callback server

HTTP_PORT

Port for HTTP transport. When set, enables streamable HTTP mode instead of stdio.

HTTP_HOSTdefault 127.0.0.1

Bind address for HTTP transport (default: 127.0.0.1)

ALLOWED_ORIGINS

Comma-separated allowed Origin headers for HTTP mode. Cross-origin requests rejected if unset.

TEMPORAL_CORTEX_TELEMETRY

Override telemetry consent: 'off' to disable, 'on' to enable anonymous usage analytics.

REDIS_URLS

Comma-separated Redis URLs. When set, activates Platform Mode with distributed locking.

claude_desktop_config.json

{
  "mcpServers": {
    "temporal-cortex-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@temporal-cortex/cortex-mcp@0.5.0"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "<YOUR_GOOGLE_CLIENT_ID>",
        "GOOGLE_CLIENT_SECRET": "<YOUR_GOOGLE_CLIENT_SECRET>",
        "GOOGLE_OAUTH_CREDENTIALS": "<YOUR_GOOGLE_OAUTH_CREDENTIALS>",
        "MICROSOFT_CLIENT_ID": "<YOUR_MICROSOFT_CLIENT_ID>",
        "MICROSOFT_CLIENT_SECRET": "<YOUR_MICROSOFT_CLIENT_SECRET>",
        "TIMEZONE": "<YOUR_TIMEZONE>",
        "WEEK_START": "monday",
        "TENANT_ID": "<YOUR_TENANT_ID>",
        "LOCK_TTL_SECS": "30",
        "OAUTH_REDIRECT_PORT": "8085",
        "HTTP_PORT": "<YOUR_HTTP_PORT>",
        "HTTP_HOST": "127.0.0.1",
        "ALLOWED_ORIGINS": "<YOUR_ALLOWED_ORIGINS>",
        "TEMPORAL_CORTEX_TELEMETRY": "<YOUR_TEMPORAL_CORTEX_TELEMETRY>",
        "REDIS_URLS": "<YOUR_REDIS_URLS>"
      }
    }
  }
}