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 connecting this server to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-05-13 · ★ 3 · #645 OF 848 MAINTAINED OTHER · VERIFIED 2026-08-25

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-08-25

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 #645 of 848 actively-maintained other servers as of 2026-08-25.
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-08-25, 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-08-25; 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 · Clipboard MCP · Molpha MCP · MolTrust MCP Server · Monday Com

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