← Index

Temporal Cortex Calendar MCP

io.github.billylui/temporal-cortex-mcp·v0.5.0·Calendar & Time
Quality Score
82
/100

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

§01  Install
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "temporal-cortex-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@temporal-cortex/cortex-mcp"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "<google_client_id>",
        "GOOGLE_CLIENT_SECRET": "<your-google_client_secret>",
        "GOOGLE_OAUTH_CREDENTIALS": "<google_oauth_credentials>",
        "MICROSOFT_CLIENT_ID": "<microsoft_client_id>",
        "MICROSOFT_CLIENT_SECRET": "<your-microsoft_client_secret>",
        "TIMEZONE": "<timezone>",
        "WEEK_START": "monday",
        "TENANT_ID": "<tenant_id>",
        "LOCK_TTL_SECS": "30",
        "OAUTH_REDIRECT_PORT": "8085",
        "HTTP_PORT": "<http_port>",
        "HTTP_HOST": "127.0.0.1",
        "ALLOWED_ORIGINS": "<allowed_origins>",
        "TEMPORAL_CORTEX_TELEMETRY": "<temporal_cortex_telemetry>",
        "REDIS_URLS": "<redis_urls>"
      }
    }
  }
}
Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "temporal-cortex-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@temporal-cortex/cortex-mcp"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "<google_client_id>",
        "GOOGLE_CLIENT_SECRET": "<your-google_client_secret>",
        "GOOGLE_OAUTH_CREDENTIALS": "<google_oauth_credentials>",
        "MICROSOFT_CLIENT_ID": "<microsoft_client_id>",
        "MICROSOFT_CLIENT_SECRET": "<your-microsoft_client_secret>",
        "TIMEZONE": "<timezone>",
        "WEEK_START": "monday",
        "TENANT_ID": "<tenant_id>",
        "LOCK_TTL_SECS": "30",
        "OAUTH_REDIRECT_PORT": "8085",
        "HTTP_PORT": "<http_port>",
        "HTTP_HOST": "127.0.0.1",
        "ALLOWED_ORIGINS": "<allowed_origins>",
        "TEMPORAL_CORTEX_TELEMETRY": "<temporal_cortex_telemetry>",
        "REDIS_URLS": "<redis_urls>"
      }
    }
  }
}
Cline (cline_mcp_settings.json)
npx -y @temporal-cortex/cortex-mcp
§02  Environment variables
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.

§03  MCP Quality Score  ·  methodology
freshness
22
completeness
15
installability
25
documentation
15
stability
5
§04  Alternatives in Calendar & Time