English Français العربية

Weekness — Week & Calendar Utilities

Official registry Productivity

MCP server with ISO week and calendar tools for date conversion, week math, and weekday lookups.

Source code Documentation

What can you do with Weekness — Week & Calendar Utilities?

  • current_date: Get today's date (YYYY-MM-DD) and weekday name
  • current_week: Get today's ISO week year, week number, week string, and weekday name
  • timestamp_to_week: Convert a date or timestamp to its ISO week number and week string
  • week_to_dates: Get the Monday start date and Sunday end date for an ISO year and week number
  • add_weeks: Add or subtract weeks from a date or week string
  • weeks_between: Calculate the number of weeks between two dates
  • weekday_of_date: Get the weekday name for a given date
  • nearest_weekday: Find the nearest past or future occurrence of a given weekday

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

OCI package ghcr.io/dvdksn/weekness:1.0.0
Claude Code 
claude mcp add weekness-week-calendar-utilities -- docker run -i --rm ghcr.io/dvdksn/weekness:1.0.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "weekness-week-calendar-utilities": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/dvdksn/weekness:1.0.0"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Weekness MCP Server
  2. Tools
  3. Installation
  4. Usage
  5. Supported Timestamp Formats

Weekness MCP Server

An MCP (Model Context Protocol) server that provides week and calendar helper tools for converting between dates and ISO weeks, performing week arithmetic, and looking up weekday names.

Tools

  • current_date: Get today's date (YYYY-MM-DD) and weekday name
  • current_week: Get today's ISO week year, week number, week string, and weekday name
  • timestamp_to_week: Convert a date or timestamp to its ISO week number and week string
  • week_to_dates: Get the Monday start date and Sunday end date for an ISO year and week number
  • add_weeks: Add or subtract weeks from a date or week string
  • weeks_between: Calculate the number of weeks between two dates
  • weekday_of_date: Get the weekday name for a given date
  • nearest_weekday: Find the nearest past or future occurrence of a given weekday

Installation

Docker
docker run --rm -i ghcr.io/dvdksn/weekness:latest
Build from source
go build -o weekness .

Usage

This MCP server communicates over stdio and is designed to be used with MCP clients like Claude Desktop or other applications that support the Model Context Protocol.

Configure in Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "weekness": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "ghcr.io/dvdksn/weekness:latest"]
    }
  }
}

Or if running from a local build:

{
  "mcpServers": {
    "weekness": {
      "command": "/path/to/weekness"
    }
  }
}

Supported Timestamp Formats

  • ISO 8601 with time: 2024-03-15T10:30:00Z
  • ISO 8601 with timezone: 2024-03-15T10:30:00-07:00
  • Date only: 2024-03-15
  • ISO week string: 2024-W15 (where accepted)

Frequently asked questions

What is Weekness — Week & Calendar Utilities?

MCP server with ISO week and calendar tools for date conversion, week math, and weekday lookups.

How do I install Weekness — Week & Calendar Utilities?

It runs on your machine. In Claude Code: claude mcp add weekness-week-calendar-utilities -- docker run -i --rm ghcr.io/dvdksn/weekness:1.0.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Weekness — Week & Calendar Utilities need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Weekness — Week & Calendar Utilities open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains Weekness — Week & Calendar Utilities?

It is published by dvdksn. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.