MCP DateTimeSAFE
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
A TypeScript implementation of a Model Context Protocol (MCP) server that provides datetime and timezone information to agentic systems and chat REPLs.
Overview
MCP DateTime is a simple server that implements the Model Context Protocol to provide datetime and timezone information to AI agents and chat interfaces. It allows AI systems to:
- Get the current time in the local system timezone
- Get the current time in any valid timezone
- List all available timezones
- Access timezone information through URI resources
Installation
From npm
npm install -g mcp-datetime
From source
git clone https://github.com/odgrmi/mcp-datetime.git cd mcp-datetime npm install npm run build
Usage
Command Line
MCP DateTime can be run in two modes:
1. Standard I/O Mode (Default)
This mode is ideal for integrating with AI systems that support the MCP protocol through standard input/output:
mcp-datetime
2. Server-Sent Events (SSE) Mode
This mode starts an HTTP server that provides SSE transport for the MCP protocol:
mcp-datetime --sse
You can also specify a custom port and URI prefix:
mcp-datetime --sse --port=8080 --prefix=/api/datetime
Environment Variables
PORT: Sets the port for SSE mode (default: 3000)URI_PREFIX: Sets the URI prefix for SSE mode (default: none)
Available Tools
MCP DateTime provides the following tools:
get-current-time
Returns the current time in the system's local timezone.
get-current-timezone
Returns the current system timezone.
get-time-in-timezone
Returns the current time in a specified timezone.
Parameters:
timezone: The timezone to get the current time for (e.g., "America/New_York")
list-timezones
Returns a list of all available timezones.
Resource URIs
MCP DateTime also provides access to timezone information through resource URIs
45acfd0bda00OBSERVED · 2026-10-12Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control.
claude mcp add mcp-datetime -- npx -y @odgrim/[email protected]
{
"mcpServers": {
"mcp-datetime": {
"command": "npx",
"args": [
"-y",
"@odgrim/[email protected]"
]
}
}
}Exposed tools (4)
4 read · 0 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
get-current-time | read | Get the current time in the configured local timezone |
get-current-timezone | read | Get the current system timezone |
get-time-in-timezone | read | Get the current time in a specific timezone |
list-timezones | read | List all available timezones |
Trust audit
SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | PASS |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- none-observed
- Network
- none-observed
- Shell
- none-observed
- Dependencies
- not all pinned
- Secrets in source
- none-found
Findings (1)
@modelcontextprotocol/sdk, @types/express, express, zod, @types/jest, @types/node, jest, shx
Gates applied: no_behavioural_pass.
45acfd0bda00full audit observations/trust-audit/mcp-server/odgrim__mcp-datetime.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-12 | 45acfd0bda00 | SAFE | B | 89 | first audit |
Questions
What tools does @odgrim/mcp-datetime expose?
4 in total: 4 read-only, 0 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is @odgrim/mcp-datetime safe to connect to an agent?
The audit found nothing in the source that contradicts what it says it does, and graded it B (89/100). Grade A is held back for packages that have also passed a sandboxed behavioural run, which is why a clean server reads B.
What credentials does @odgrim/mcp-datetime need?
No credential environment variables were found in its source, so it appears to need none.
How does @odgrim/mcp-datetime run?
It speaks sse and stdio, so it runs as a local process your client starts. It is published on npm as @odgrim/mcp-datetime at 0.2.0.
How current is this page?
The grade is for one exact copy of the source (45acfd0bda00), read on 2026-10-12. The repository is watched and re-audited when it changes.