dvdksn avatar

Weekness — Week & Calendar Utilities

dvdksn/weekness

Need to work with ISO week numbers in your LLM workflows? This server gives you eight calendar operations: get current date or week, convert timestamps to ISO weeks, map week numbers back to date ranges, do week arithmetic with add_weeks and weeks_between, and look up weekday names or find the nearest occurrence of a specific weekday. It handles ISO 8601 timestamps, plain dates, and week strings like 2024-W15. Runs over stdio via Docker or a Go binary. Useful when you're building scheduling tools, processing time-series data bucketed by week, or just need reliable date math without reimplementing ISO week logic.

tools
8
transport
STDIO
last updated
Jun 3, 2026

Tools

8 tools

Public tool metadata for what this MCP can expose to an agent.

current_dateGet today's date (YYYY-MM-DD) and weekday name

Get today's date (YYYY-MM-DD) and weekday name

No parameter schema in public metadata yet.

current_weekGet today's ISO week year, week number, week string, and weekday name

Get today's ISO week year, week number, week string, and weekday name

No parameter schema in public metadata yet.

timestamp_to_weekConvert a date or timestamp to its ISO week number and week string

Convert a date or timestamp to its ISO week number and week string

No parameter schema in public metadata yet.

week_to_datesGet the Monday start date and Sunday end date for an ISO year and week number

Get the Monday start date and Sunday end date for an ISO year and week number

No parameter schema in public metadata yet.

add_weeksAdd or subtract weeks from a date or week string

Add or subtract weeks from a date or week string

No parameter schema in public metadata yet.

weeks_betweenCalculate the number of weeks between two dates

Calculate the number of weeks between two dates

No parameter schema in public metadata yet.

weekday_of_dateGet the weekday name for a given date

Get the weekday name for a given date

No parameter schema in public metadata yet.

nearest_weekdayFind the nearest past or future occurrence of a given weekday

Find the nearest past or future occurrence of a given weekday

No parameter schema in public metadata yet.

Sponsors

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


View the full README on GitHub

Details

Repository
github.com/dvdksn/weekness
Category
Productivity & Office
Package
ghcr.io/dvdksn/weekness:1.0.0
Transport
STDIO
Registry
MCP registry, active

Related Productivity & Office MCP servers

View all
1invapi-org avatarInvapi Mcpinvapi-org/invapi-mcpExtract, create, convert & validate invoices (UBL, CII, XRechnung, ZUGFeRD, PDF, Excel)0stars
2agenson-tools avatarDocument Parseragenson-tools/document-parser-mcpParse and extract structured data from various document formats (PDF, Word, HTML).0stars
3alx1p avatarLuma Eventsalx1p/luma-cal-mcpDiscover events from Luma — search by category, city, distance, and keywords with calendar export0stars
4gammell53 avatarClawworkgammell53/clawwork-mcpAI agent project management — task boards, progress tracking, and cost reporting.0stars
5igormilovanovic avatarMCP Data Converterio.github.igormilovanovic/data-converterConvert between 200+ format pairs: JSON, CSV, XML, YAML, PDF, Excel, DOCX and more.0stars
6levelsofself avatarAi Opslevelsofself/mcp-ops-serverAI operations management: 12 specialized agents, task dispatch, and team coordination.0stars