DateTime MCP Server

by bossjones

381 downloads
Not rated
GitHub

Description

# DateTime MCP Server A MCP (Model Completions Protocol) server that provides datetime functionality along with simple note management. ## Overview This server implements the MCP protocol and offers various datetime-related tools and resources, including: - Current date and time…

About

# DateTime MCP Server A MCP (Model Completions Protocol) server that provides datetime functionality along with simple note management. ## Overview This server implements the MCP protocol and offers various datetime-related tools and resources, including: - Current date and time in different formats - Date formatting…

Details

Author
bossjones
Downloads
381
Categories
Other

- Provides datetime resources: current time, today’s date, current time in 24h format.
- Allows note management via note://internal/{name} resources.
- Offers tools: add-note, get-current-time (ISO, readable, Unix timestamp, RFC3339), format-date.
- Includes prompts: summarize-notes, schedule-event.
- Implements MCP protocol for client integration.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name DateTime MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Clone the repository, create a virtual environment with uv, and install dependencies using uv sync. Run the server with uv run python -m datetime_mcp_server.server. Connect using any MCP client, for example uv run mcp connect datetime-mcp-server. The server listens on stdin/stdout for MCP protocol messages.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "datetime mcp server": {
            "datetime-mcp-server": {
                "command": "uv",
                "args": [
                    "venv"
                ]
            }
        }
    }
}

McpServers

{
    "datetime-mcp-server": {
        "command": "uv",
        "args": [
            "venv"
        ]
    }
}

DateTime MCP Server

A MCP (Model Completions Protocol) server that provides datetime functionality along with simple note management.

Overview

This server implements the MCP protocol and offers various datetime-related tools and resources, including:

- Current date and time in different formats
- Date formatting utilities
- Event scheduling prompts
- Simple note management functionality

The server can be used by any MCP client to access date and time information and manage simple notes.

Features

Resources

The server provides the following 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

The server provides the following tools:

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

Prompts

The server provides the following prompts:

- summarize-notes - Creates a summary of all notes
- schedule-event - Helps schedule an event at a specific time

Installation

1. Clone the repository:

git clone https://github.com/bossjones/datetime-mcp-server.git
cd datetime-mcp-server

2. Create a virtual environment:

uv venv
source .venv/bin/activate

3. Install the dependencies:

uv sync

Usage

Running the Server

To run the server:

uv run python -m datetime_mcp_server.server

The server will start and listen on stdin/stdout for MCP protocol messages.

Connecting to the Server

You can connect to the server using any MCP client. For example, using the MCP CLI:

uv run mcp connect datetime-mcp-server

Development

Installing Development Dependencies

```bash

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.