temporal-mcp-server

An MCP server providing time, timezone, and duration tools including current time retrieval, timezone conversion, duration arithmetic with DST awareness, and elapsed time calculation. It supports local stdio/HTTP execution or a hosted Cloudflare Workers instance.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Community listingStreamable HTTPNo sign-inEndpoint checked 2026-11-01Published by jordanburke

MCP endpoint (Streamable HTTP)

https://time.somamcp.com/mcp

Vendor documentation

What you can do with it

Get current time in any IANA timezone
Convert ISO-8601 timestamps between timezones
Add or subtract durations with calendar-aware arithmetic
Calculate elapsed time between two timestamps

Source and maintenance

Community listingRegistry 0.2.3

mcp-registry: io.github.jordanburke/temporal-mcp-server@0.2.3 Source repository

Maintenance checked: Nov 1, 2026, 8:44 AM UTC

Protocol and capabilities

Server: temporal-mcp-server 0.2.3
MCP protocol: 2025-11-25
Tools: 5 advertised
Resources: Not advertised
Resource templates: Not advertised
Prompts: Not advertised

Server-advertised capabilities

{
  "tools": {}
}

Tools

5 advertised

info

Advertised by the server during the last successful anonymous check.

Returns identity and build information for this server (name, version, build commit, runtime, capability counts)

info input schema

{
  "type": "object"
}

get_current_time

Advertised by the server during the last successful anonymous check.

Return the current time as an epoch, a UTC ISO-8601 timestamp, and the wall-clock time in a given timezone.

get_current_time input schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "timezone": {
      "type": "string",
      "description": "IANA timezone identifier, e.g. 'America/New_York'. Defaults to UTC."
    }
  },
  "additionalProperties": false
}

convert_timezone

Advertised by the server during the last successful anonymous check.

Render an ISO-8601 timestamp as wall-clock time in a target timezone.

convert_timezone input schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "isoTimestamp",
    "targetTimezone"
  ],
  "properties": {
    "isoTimestamp": {
      "type": "string",
      "description": "ISO-8601 timestamp to convert, e.g. '2026-08-17T14:30:00Z'."
    },
    "sourceTimezone": {
      "type": "string",
      "description": "IANA timezone used to interpret `isoTimestamp` when it carries no 'Z' or offset. Ignored otherwise. Defaults to UTC."
    },
    "targetTimezone": {
      "type": "string",
      "description": "IANA timezone identifier to render in."
    }
  },
  "additionalProperties": false
}

add_duration

Advertised by the server during the last successful anonymous check.

Add an ISO-8601 duration to a timestamp, in a timezone. Date units (Y/M/D) are calendar-aware: P1D across a DST boundary keeps the same wall-clock time the next day, and P1M on Jan 31 clamps to the end of February. Time units (H/M/S) are exact elapsed time, so PT24H really is 24 hours. Prefix the duration with '-' to subtract.

add_duration input schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "duration",
    "isoTimestamp"
  ],
  "properties": {
    "duration": {
      "type": "string",
      "description": "ISO-8601 duration, e.g. 'P1D', 'PT30M', 'P1Y2M3DT4H5M6S', or '-P1W'."
    },
    "timezone": {
      "type": "string",
      "description": "IANA timezone governing the arithmetic — calendar units are applied to this zone's wall clock, and a timestamp with no 'Z' or offset is read as wall-clock time here. Defaults to UTC."
    },
    "isoTimestamp": {
      "type": "string",
      "description": "ISO-8601 timestamp to shift."
    }
  },
  "additionalProperties": false
}

time_between

Advertised by the server during the last successful anonymous check.

Exact elapsed time between two ISO-8601 timestamps, broken into days/hours/minutes/seconds plus a human-readable summary. All components share one sign, so they sum correctly; `direction` is 'past', 'future', or 'same'.

time_between input schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "from",
    "to"
  ],
  "properties": {
    "to": {
      "type": "string",
      "description": "End of the interval, as an ISO-8601 timestamp."
    },
    "from": {
      "type": "string",
      "description": "Start of the interval, as an ISO-8601 timestamp."
    },
    "timezone": {
      "type": "string",
      "description": "IANA timezone used to interpret timestamps that carry no 'Z' or offset. Defaults to UTC."
    }
  },
  "additionalProperties": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks: 1 of 1 (100%)
Average latency: 181 ms
95th percentile latency: 181 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

Nov 1, 2026, 8:58 AM UTC · probe · passed · 181 ms · metadata changed · 5 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.

Claude Code configuration

claude mcp add --transport http temporal-mcp-server-somamcp https://time.somamcp.com/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).

Codex configuration

codex mcp add temporal-mcp-server-somamcp --url https://time.somamcp.com/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable temporal-mcp-server-somamcp in your MCP settings.

Cursor configuration

{
  "mcpServers": {
    "temporal-mcp-server-somamcp": {
      "url": "https://time.somamcp.com/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).

Cline configuration

{
  "mcpServers": {
    "temporal-mcp-server-somamcp": {
      "type": "streamableHttp",
      "url": "https://time.somamcp.com/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start temporal-mcp-server-somamcp and inspect its tools.

VS Code configuration

{
  "servers": {
    "temporal-mcp-server-somamcp": {
      "type": "http",
      "url": "https://time.somamcp.com/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.

Gemini CLI configuration

gemini mcp add --transport http temporal-mcp-server-somamcp https://time.somamcp.com/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.

Claude Desktop configuration

{
  "mcpServers": {
    "temporal-mcp-server-somamcp": {
      "url": "https://time.somamcp.com/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.

Windsurf configuration

{
  "mcpServers": {
    "temporal-mcp-server-somamcp": {
      "serverUrl": "https://time.somamcp.com/mcp"
    }
  }
}

Let your agent find its tools

Find servers like temporal-mcp-server from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows