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 GitHubWhat 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-reviewworkflow - Create a new schedule to run
cleanup-tasksevery 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.