Temporal Cortex Calendar MCP Server

by billyluiio.github.billylui/temporal-cortex-mcpv0.5.0

Calendar middleware for scheduling, multi-calendar availability and conflict-free booking across Google Calendar, Outlook and CalDAV, with RRULE expansion.

Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Stale8mo ago

Install Temporal Cortex Calendar MCP server

claude mcp add cortex -e GOOGLE_CLIENT_SECRET='<google-client-secret>' -e MICROSOFT_CLIENT_SECRET='<microsoft-client-secret>' -- npx -y @temporal-cortex/cortex-mcp

{
  "mcpServers": {
    "cortex": {
      "command": "npx",
      "args": [
        "-y",
        "@temporal-cortex/cortex-mcp"
      ],
      "env": {
        "GOOGLE_CLIENT_SECRET": "<google-client-secret>",
        "MICROSOFT_CLIENT_SECRET": "<microsoft-client-secret>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "cortex": {
      "command": "npx",
      "args": [
        "-y",
        "@temporal-cortex/cortex-mcp"
      ],
      "env": {
        "GOOGLE_CLIENT_SECRET": "<google-client-secret>",
        "MICROSOFT_CLIENT_SECRET": "<microsoft-client-secret>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "cortex": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@temporal-cortex/cortex-mcp"
      ],
      "env": {
        "GOOGLE_CLIENT_SECRET": "<google-client-secret>",
        "MICROSOFT_CLIENT_SECRET": "<microsoft-client-secret>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "cortex": {
      "command": "npx",
      "args": [
        "-y",
        "@temporal-cortex/cortex-mcp"
      ],
      "env": {
        "GOOGLE_CLIENT_SECRET": "<google-client-secret>",
        "MICROSOFT_CLIENT_SECRET": "<microsoft-client-secret>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
GOOGLE_CLIENT_ID	—	—	Google OAuth Client ID (required for Google Calendar)
GOOGLE_CLIENT_SECRET	—	yes	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	—	yes	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.

Freshness

Stale — last maintenance signal 8mo ago. The newest of the signals below sets the band.

Last commit (default branch)
no data · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-02-26 · 8mo ago · official registry · v0.5.0

FAQ

›How do I install the Temporal Cortex Calendar MCP server in Claude Code?

Run: claude mcp add cortex -e GOOGLE_CLIENT_SECRET='<google-client-secret>' -e MICROSOFT_CLIENT_SECRET='<microsoft-client-secret>' -- npx -y @temporal-cortex/cortex-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Temporal Cortex Calendar require an API key?

Yes. It expects GOOGLE_CLIENT_SECRET, MICROSOFT_CLIENT_SECRET, of which 2 are secrets.

›Can I use Temporal Cortex Calendar as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Temporal Cortex Calendar in the official MCP registry?

Yes, as io.github.billylui/temporal-cortex-mcp.