mcpField
W
Weekness — Week & Calendar Utilities

Weekness — Week & Calendar Utilities

Local
github.com/dvdksnProductivity0Updated 21w ago
Repository

About Weekness — Week & Calendar Utilities

Weekness is an MCP server for date and calendar calculations involving ISO weeks. It provides helper tools for applications and users that need week conversions, arithmetic, and weekday lookups.

Key features

  1. 01Get today's date and weekday
  2. 02Get the current ISO week
  3. 03Convert dates and timestamps to ISO weeks
  4. 04Find date ranges for an ISO week
  5. 05Add or compare weeks
  6. 06Look up or find weekdays

Use cases

  1. 01Convert a timestamp to an ISO week
  2. 02Find the Monday–Sunday range of a week
  3. 03Calculate weeks between two dates
  4. 04Find the nearest occurrence of a weekday

MCP support

Exposes date, ISO week, and weekday helper tools to MCP clients over stdio.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "dvdksn-weekness": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/dvdksn/weekness:1.0.0"
      ]
    }
  }
}
Run commanddocker run -i --rm ghcr.io/dvdksn/weekness:1.0.0

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
ocighcr.io/dvdksn/weekness:1.0.0

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project 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
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)

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.