Temporal MCP Server

Wall-clock awareness for LLM agents. Two tools: elapsed-time-between-turns + day rollover detection.

Remote serverstreamable-httpPython

What is the Temporal MCP server?

If you already use Temporal, the temporal mcp server is the piece that lets your assistant work with it directly. Wall-clock awareness for LLM agents. Two tools: elapsed-time-between-turns + day rollover detection.

What the server does

temporal-mcp is a tiny Model Context Protocol server that gives LLM agents a sense of time between turns. Two tools, a few hundred lines, stdlib + mcp + platformdirs. That's the whole thing.

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • temporal_tick — Advance the clock for a thread and return a snapshot. Call once per user turn.
  • temporal_peek — Read-only. Same shape, doesn't advance state. Use it when you want the gap delta but the call isn't the canonical "one tick per user turn" event

Installation

Because this one is hosted, setup is mostly authentication — you point your client at the endpoint and approve access. Nothing runs on your machine, so there is no runtime to keep patched.

Where it fits

This sits in the AI and media services group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Temporal's toolset — temporal_tick, temporal_peek — is a fair guide to whether it matches your workflow. It is maintained by MirrorEthic; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Temporal's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Worth knowing first

  • Your data travels to the provider's service, so the usual questions apply about what you send and what they retain.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Available tools

ToolWhat it does
temporal_tickAdvance the clock for a thread and return a snapshot. **Call once per user turn.**
temporal_peekRead-only. Same shape, doesn't advance state. Use it when you want the gap delta but the call isn't the canonical "one tick per user turn" event.

How to install the Temporal MCP server

#### Claude Desktop

```json
{
  "mcpServers": {
    "temporal": {
      "command": "temporal-mcp"
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Example prompts to try

  • Use Temporal to temporal tick.
  • Use Temporal to temporal peek.

Frequently asked questions

It connects Temporal to MCP-compatible AI assistants such as Claude and Cursor, exposing 2 tools (temporal_tick, temporal_peek) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Temporal directly.