mcpField
T
Temporal Cortex MCP

Temporal Cortex MCP

Local
github.com/billyluiProductivity0
Repository

About Temporal Cortex MCP

Temporal Cortex is a Model Context Protocol server that gives AI agents deterministic calendar capabilities—temporal context, datetime resolution, multi-calendar availability merging across Google Calendar, Microsoft Outlook, and CalDAV, and conflict-free booking with Two-Phase

#rust#ai#calendar#mcp#google-calendar#booking#rrule#llm#mcp-server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "temporal-cortex": {
      "command": "npx",
      "args": [
        "-y",
        "@temporal-cortex/cortex-mcp"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
        "GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
        "GOOGLE_OAUTH_CREDENTIALS": "<GOOGLE_OAUTH_CREDENTIALS>",
        "MICROSOFT_CLIENT_ID": "<MICROSOFT_CLIENT_ID>",
        "MICROSOFT_CLIENT_SECRET": "<MICROSOFT_CLIENT_SECRET>",
        "TIMEZONE": "<TIMEZONE>",
        "WEEK_START": "<WEEK_START>",
        "TENANT_ID": "<TENANT_ID>",
        "LOCK_TTL_SECS": "<LOCK_TTL_SECS>",
        "OAUTH_REDIRECT_PORT": "<OAUTH_REDIRECT_PORT>",
        "HTTP_PORT": "<HTTP_PORT>",
        "HTTP_HOST": "<HTTP_HOST>",
        "ALLOWED_ORIGINS": "<ALLOWED_ORIGINS>",
        "TEMPORAL_CORTEX_TELEMETRY": "<TEMPORAL_CORTEX_TELEMETRY>",
        "REDIS_URLS": "<REDIS_URLS>"
      }
    }
  }
}
Run commandnpx -y @temporal-cortex/cortex-mcp
Environment variables to set
GOOGLE_CLIENT_IDGoogle OAuth Client ID (required for Google Calendar)
GOOGLE_CLIENT_SECRETSecretGoogle OAuth Client Secret (required if using Google Calendar)
GOOGLE_OAUTH_CREDENTIALSSecretPath to Google OAuth JSON credentials file (alternative to CLIENT_ID + SECRET)
MICROSOFT_CLIENT_IDAzure AD app ID (required for Outlook Calendar)
MICROSOFT_CLIENT_SECRETSecretAzure AD client secret (required for Outlook Calendar)
TIMEZONEIANA timezone override (e.g., America/New_York). Overrides stored config and OS detection.
WEEK_STARTWeek start day: 'monday' (default, ISO 8601) or 'sunday'. Overrides stored config.
TENANT_IDUUID for tenant isolation (auto-generated if not set)
LOCK_TTL_SECSLock time-to-live in seconds for booking safety
OAUTH_REDIRECT_PORTSecretPort for the local OAuth callback server
HTTP_PORTPort for HTTP transport. When set, enables streamable HTTP mode instead of stdio.
HTTP_HOSTBind address for HTTP transport (default: 127.0.0.1)
ALLOWED_ORIGINSComma-separated allowed Origin headers for HTTP mode. Cross-origin requests rejected if unset.
TEMPORAL_CORTEX_TELEMETRYOverride telemetry consent: 'off' to disable, 'on' to enable anonymous usage analytics.
REDIS_URLSComma-separated Redis URLs. When set, activates Platform Mode with distributed locking.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@temporal-cortex/cortex-mcp0.5.0

Tools

12

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
datetimestringYesRFC 3339 datetime to adjust.
timezonestringNoIANA timezone for day-level adjustments. Omit to use configured timezone.
adjustmentstringYesDuration adjustment (e.g., "+2h", "-30m", "+1d2h").

Details

The maintainer has not added details yet. Check the README in the repository.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.