MCP Server

Temporal Cortex Calendar MCP MCP Server

io.github.billylui/temporal-cortex-mcp

Repository Registry

What is the Temporal Cortex Calendar MCP MCP server?

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

How to install Temporal Cortex Calendar MCP

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

GOOGLE_CLIENT_ID
Google OAuth Client ID (required for Google Calendar)
GOOGLE_CLIENT_SECRET
secret
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_SECRET
secret
Azure AD client secret (required for Outlook Calendar)
TIMEZONE
IANA timezone override (e.g., America/New_York). Overrides stored config and OS detection.
WEEK_START
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_SECS
Lock time-to-live in seconds for booking safety
OAUTH_REDIRECT_PORT
Port for the local OAuth callback server
HTTP_PORT
Port for HTTP transport. When set, enables streamable HTTP mode instead of stdio.
HTTP_HOST
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.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "temporal-cortex-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@temporal-cortex/cortex-mcp"
      ],
      "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": "<YOUR_WEEK_START>",
        "TENANT_ID": "<YOUR_TENANT_ID>",
        "LOCK_TTL_SECS": "<YOUR_LOCK_TTL_SECS>",
        "OAUTH_REDIRECT_PORT": "<YOUR_OAUTH_REDIRECT_PORT>",
        "HTTP_PORT": "<YOUR_HTTP_PORT>",
        "HTTP_HOST": "<YOUR_HTTP_HOST>",
        "ALLOWED_ORIGINS": "<YOUR_ALLOWED_ORIGINS>",
        "TEMPORAL_CORTEX_TELEMETRY": "<YOUR_TEMPORAL_CORTEX_TELEMETRY>",
        "REDIS_URLS": "<YOUR_REDIS_URLS>"
      }
    }
  }
}