Temporal-MCP: Wall-Clock Awareness for LLMs with OAuth Support

✍️ OpenClawRadar📅 Published: May 14, 2026🔗 Source
Temporal-MCP: Wall-Clock Awareness for LLMs with OAuth Support
Ad

Temporal-MCP is a new MCP server designed to solve a common failure mode in agent stacks: the model has no awareness of how much time has passed between turns. It greets you with 'good morning' at 11 PM, picks up a conversation three weeks later as if no time has passed, or computes 'today's data' based on stale context. Two tools are provided: temporal_tick and temporal_peek. They return elapsed time since the last turn, day-rollover detection, and a fresh-thread flag, both as a human-readable header and as JSON.

Setup and Usage

Local stdio: pip install temporal-mcp (works with Claude Desktop, Cursor, Cline, Zed, Claude Code).

Hosted with OAuth (claude.ai / ChatGPT): visit https://temporal-mcp.dev/connect, click 'Generate OAuth Credentials', and paste into your custom connector. Full OAuth 2.0 with PKCE and refresh tokens. No signup required — the credential pair is the identity. Verified working in claude.ai.

Hosted with raw bearer (any client that supports custom headers): use Authorization: Bearer <any-opaque-string> against https://temporal-mcp.dev/mcp. The token is SHA-256 hashed; the server never sees the plaintext.

Self-host: Cloudflare Workers deploy using the workers/ directory in the repo. The free tier covers ~100k requests/day.

Grok/xAI: https://temporal-mcp.dev/mcp/<string> (verified working in Grok).

Ad

Implementation Details

MIT licensed. ~150 lines of stdlib Python on the local side, ~400 lines of TypeScript on the hosted side (engine + OAuth provider), both with tests. Listed in the official MCP Registry. Smithery and Glama submissions are in flight.

The JSON signals day_rollover and delta_sec can be used for context decay and resume detection, among other use cases.

Source: github.com/MirrorEthic/temporal-mcp

📖 Read the full source: r/ClaudeAI

Ad

👀 See Also