Temporal MCP

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.

People who work with temporal and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-05-13 · ★ 3 · #704 OF 945 MAINTAINED OTHER · VERIFIED 2026-09-18

MIT · TypeScript servers · how we verify → /methodology

01 · Install Temporal MCP

before you install - you'll need

The README does not document required environment variables for a basic install.

Claude Code

claude mcp add mirrorethic-temporal-mcp --transport http https://temporal-mcp.dev/mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "mirrorethic-temporal-mcp": {
      "url": "https://temporal-mcp.dev/mcp"
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

https://temporal-mcp.dev/mcp

transport: streamable-http

endpoint alive - responded to MCP initialize · probed 2026-09-17

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions · remote - your agent's requests go to temporal-mcp.dev

endpoint auth accepted our unauthenticated MCP initialize - no credentials needed to connect

license MIT - declared in the repository

pypi package temporal-mcp - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.MirrorEthic is GitHub-verified and matches the repo owner

03 · What Temporal MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

An agent gets 2 documented tools, including temporal_tick, temporal_peek.

The 2 tools it gives your agent

Extracted from the project's README - what temporal-mcp lets an agent do.

temporal_tick: - Advance the clock for a thread and return a snapshot. Call once per user
temporal_peek: - Read-only. Same shape, doesn't advance state. Use it when you want the gap

04 · Who maintains Temporal MCP

temporal-mcp is maintained by mirrorethic. It's the only MCP server we track from this author; the repo dates to May 2026.

05 · Facts

repository: github.com/mirrorethic/temporal-mcp
website: https://temporal-mcp.dev/
category: other - ranked #704 of 945 actively-maintained other servers as of 2026-09-18.
registry: io.github.MirrorEthic/temporal-mcp (active, first published 2026-05-13)
packages: pypi:temporal-mcp

06 · Temporal MCP FAQ

What is Temporal MCP?

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.

Is Temporal MCP still maintained?

Yes - as of 2026-09-18, its last commit was 2026-05-13. We re-verify nightly.

How do I install Temporal MCP?

Run `uvx temporal-mcp`. The README does not document required environment variables for a basic install. You can also paste the ready-made client config above.

Does Temporal MCP require authentication?

No - the endpoint accepted our unauthenticated MCP initialize when probed on 2026-09-17; you can connect without credentials.

07 · Alternatives to Temporal MCP

Alternatives to Temporal MCP

Maintained other servers if Temporal MCP isn't the fit.

More MCP servers to compare · AI CLI MCP · Mlab Sh · PDF Modifier · Clipboard MCP · Molpha MCP

More TypeScript MCP servers · Grantex · T2000 · ComfyUI Builder · Oura Ring MCP · Mjucius Cozi MCP · see all