Time MCP Server

Get the current UTC time in RFC 3339 format.

OtherPythonv1.1.1

Time MCP Server

A minimal Model Context Protocol (MCP) server built with Python.

The server provides one simple tool:

  • get_current_utc_time - Gets the current UTC date and time in RFC 3339 format

Quick start

Prerequisites:

  • Python 3.8 or later
  • Claude Desktop or another MCP-compatible client

Install and run with:

pip install time-mcp-pypi  # or from a local clone: pip install -e .
time-mcp-pypi

Configuration

To use this server with Claude Desktop, add the following to your MCP configuration file:

Windows

Add to %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "time-server": {
      "command": "time-mcp-pypi"
    }
  }
}

macOS

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "time-server": {
      "command": "time-mcp-pypi"
    }
  }
}

Usage

Once configured, you can use the time tool in Claude Desktop:

  • "What's the current UTC time?"
  • "Give me an RFC 3339 timestamp"

Publishing New Versions

To publish a new version of the package:

  1. Update the version in pyproject.toml, and commit as Release x.y.z

  2. Tag the release with a version number prefixed with 'v':

    git tag v1.0.1
    
  3. Push the tag to trigger the publishing pipeline:

    git push --tags
    

Then the CI/CD pipeline will automatically publish the package.

CI/CD

The project includes GitHub Actions workflows for:

  • Build & Test - Builds and tests the Python package
  • Publish - Automatically publishes to PyPI and creates GitHub releases on version tags

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
uvx time-mcp-pypi

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-domdomegg-time-mcp-pypi": {
      "command": "uvx",
      "args": [
        "time-mcp-pypi"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

time-mcp-pypipypi

Compatible MCP Clients

Time MCP Server works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More