Skip to main content
MCP server CX Codex

Temporal — Claude Code MCP server: what it does, how to install

Connects AI coding assistants to Temporal orchestration, letting them trigger workflows, inspect execution events, send signals, and manage cron schedules.

no license updated 2026-10-29

Open on GitHub

What Temporal does

This server exposes tools for working with both local and remote Temporal clusters. Assistants can start workflows (start_workflow), inspect statuses, retrieve execution results, and trace full history events (get_workflow_history). It also provides controls to send signals, query execution state without altering it, cancel tasks, or terminate stubborn workflows individually and in batches.

Schedule management includes creating recurring jobs via cron expressions, pausing, resuming, and manually triggering executions. When data is encrypted by a codec server, passing --codec-endpoint allows automatic decoding of payload fields and failures inside workflow event streams.

Switching namespaces during a session is blocked unless configured: the server restricts calls to the default namespace until TEMPORAL_ALLOWED_NAMESPACES is provided with an explicit list or *. Execution works directly via uvx temporal-mcp-server or the mcp/temporal Docker image.

What it helps with

  • trigger Temporal workflows and inspect execution results
  • inspect workflow event logs to diagnose task failures
  • dispatch signals or query the state of active runs
  • configure and pause recurring jobs with cron syntax
  • cancel or terminate batches of executions via query filters

Example prompts for the agent

  • Check the event history for workflow order-processing-42
  • Send an approval signal to the running invoice-review workflow
  • Create a new schedule to run cleanup-tasks every Sunday at midnight

How to install Temporal

Install

The MCP registry has no launch command for it: see the repository README

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about Temporal

How do you configure the Temporal MCP server?

Add it to your MCP client configuration (such as .vscode/mcp.json). You can execute it via uvx temporal-mcp-server using --host and --namespace CLI flags, or launch the mcp/temporal Docker container with environment variables.

What does the Temporal MCP server do?

It gives your AI environment tools to execute workflows, monitor event histories, handle signals, and maintain schedules on a Temporal cluster.

Why does the server reject commands targeting another namespace?

Tool calls cannot override the primary namespace unless permitted beforehand. Define TEMPORAL_ALLOWED_NAMESPACES with a comma-delimited allowlist or set it to * to enable broader access.

Similar MCP servers

All MCP servers for Backend and APIs →

Project sponsors

Companies that keep this analytics open