home / mcp / datetime mcp server

Datetime MCP Server

Provides datetime utilities and simple note management via MCP endpoints and prompts.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "bossjones-datetime-mcp-server": {
      "command": "uv",
      "args": [
        "run",
        "python",
        "-m",
        "datetime_mcp_server.server"
      ]
    }
  }
}

You can use this MCP server to access current date and time, format dates, schedule events, and manage simple notes. It provides practical datetime utilities and lightweight note storage that you can leverage from any MCP client.

How to use

Connect to the server using an MCP client and start by listing available resources. Read the current datetime resources to display the date, time, or today’s ISO date. Use the tools to get current time in various formats or to format a given date. Create and manage notes with the note functionality, and use prompts to summarize notes or schedule events.

Practical usage patterns you can follow: - Read datetime resources to display current date and time in your preferred format - Call get-current-time to fetch time in ISO, readable, Unix timestamp, or RFC3339 formats - Use format-date to convert a date string into a human-friendly representation - Add notes with add-note and retrieve them later with summarize-notes or direct reads - Schedule events with schedule-event prompts as part of planning workflows

How to install

Prerequisites you need before running the server: - Python installed on your machine - The MCP runner available in your environment (referred to as uv in commands) for executing MCP servers via stdio - A client or CLI capable of MCP interactions to connect and test the server

uv run python -m datetime_mcp_server.server

Additional notes

To connect the server and begin MCP communication, you typically start the server using the command above. From an MCP client, you can then interact with the following resources, tools, and prompts to accomplish common tasks.

Resources and tools overview

Resources
- datetime://current — The current date and time
- datetime://today — Today’s date in ISO format
- datetime://time — The current time in 24-hour format
- note://internal/{name} — User-created notes

Tools
- add-note — Add a new note with a name and content
- get-current-time — Get the current time in ISO, readable, Unix timestamp, RFC3339 formats
- format-date — Format a date string according to a given pattern

Prompts
- summarize-notes — Create a summary of all notes
- schedule-event — Help schedule an event at a specific time

Troubleshooting and debugging

If you encounter issues running the server, consider using an MCP Inspector to aid debugging. This tool provides a browser-based interface to observe and troubleshoot MCP interactions.

Available tools

add-note

Adds a new note with a name and content so you can build a small collection of notes within the server.

get-current-time

Retrieves the current time in multiple formats, including ISO, readable, Unix timestamp, and RFC3339 formats.

format-date

Formats a given date string according to a specified pattern, enabling easy date presentation.

summarize-notes

Creates a concise summary of all stored notes for quick review.

schedule-event

Prompts you to schedule an event at a specified time and integrates with your planning workflow.