Weekness — Week & Calendar Utilities

io.github.dvdksnPublished by GitHub account dvdksnv1.0.0Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyProductivity & Workflow

Overview

AI-generated overview

An MCP server that gives an assistant ISO week and calendar tools for date conversion, week arithmetic, and weekday lookups.

What you can do
Weekness exposes eight small calendar helpers over stdio: current_date and current_week return today's date, weekday name, and ISO week year, week number, and week string; timestamp_to_week converts a date or timestamp into an ISO week; week_to_dates returns the Monday and Sunday bounding an ISO year and week; add_weeks shifts a date or week string by a number of weeks; weeks_between counts weeks between two dates; weekday_of_date names the weekday of a date; and nearest_weekday finds the closest past or future occurrence of a weekday. It accepts ISO 8601 timestamps with or without time or timezone, plain dates, and ISO week strings such as 2024-W15.
When to use it
Useful when an assistant needs reliable ISO week numbering rather than guessing: sprint and reporting week labels, converting between dates and week numbers, scheduling around a specific weekday, or counting weeks between two dates.
Requirements
Runs locally as a stdio process. It can be started from the published container image ghcr.io/dvdksn/weekness:1.0.0 via Docker, or built from source with Go. No authentication, environment variables, headers, or network access are declared.
Before you install
The server only computes dates and weeks; it does not read or modify calendars, files, or other data. Installing it means running a local process or container, so the usual care applies to the image or binary you choose to run.

Installation

In SourceWeft

  1. Open Weekness — Week & Calendar Utilities in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

bash
docker run --rm -i ghcr.io/dvdksn/weekness:latest

Build from source

bash
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

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

Or if running from a local build:

json
{  "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)

Source: README.md at commit 9ae1fcb

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.