# mcp-device-datetime

A simple MCP server that exposes the host device's current date and time to clients.

This server only depends on the [MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk) and the Python standard library package [`datetime`](https://docs.python.org/3/library/datetime.html).
The tools returns the device's wall clock datetime, either in its local time zone or in UTC.

## Tools

- `get_device_local_datetime`: local time with timezone offset (e.g. `2026-02-23T17:30:45-05:00`)
- `get_device_utc_datetime`: UTC time (e.g. `2026-02-23T22:30:45+00:00`)

## Installation

Install from a local clone of this repository:

```bash
git clone https://github.com/vulpicastor/mcp-device-datetime.git
cd mcp-device-datetime
pip install .
```

## Claude Desktop Configuration

Install the package, then add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "device-datetime": {
      "command": "mcp-device-datetime"
    }
  }
}
```

The `mcp-device-datetime` command is installed by pip as part of the package. Restart Claude Desktop after editing the config.

If you installed into a conda environment or virtual environment, Claude Desktop may not have that environment active. Use `which` to find the full path to the command:
```bash
which mcp-device-datetime
```
Then use that path as the `command` value in the JSON configuration.