MCP Time Workdays Node

@tanranv5

Basic information

About MCP Time Workdays Node

No overview available yet

MCP Time Workdays Node config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "time-and-workdays-node": {
      "command": "npx",
      "args": [
        "mcp-time-workdays-node"
      ],
      "env": {}
    }
  }
}

MCP Time Workdays Node tools

获取指定时区的当前时间（支持自定义格式）

获取某月官方工作日与补班（支持 timor 与 nate 提供方）

Overview

What is Mcp_time_workdays_node?

A Model Context Protocol (MCP) Node.js server that provides current time in a specified timezone with custom formatting, and retrieves official workdays, holidays, and makeup workdays for a given year/month using free online data sources (Timor and NateScarlet holiday-cn, no API key required). Designed for MCP-compatible clients like Claude Desktop.

How to use Mcp_time_workdays_node?

Requires Node.js >= 18.17. Install globally via npm install -g mcp-time-workdays-node or run directly with npx mcp-time-workdays-node. Configure as an MCP server in your client's config (e.g., claude_desktop_config.json) using the command npx mcp-time-workdays-node. The server exposes two tools: get_current_time and get_workdays_from_api, both communicating via stdio.

Key features of Mcp_time_workdays_node

Two tools: get current time (any timezone, custom format) and query workdays/holidays by year/month
Two free online data sources: Timor (default) and NateScarlet holiday-cn (with CDN fallback)
Unified output as MCP text content for strict client compatibility
Requires only Node 18+ and the MCP SDK; no API keys or extra dependencies

Use cases of Mcp_time_workdays_node

Display the current time in any IANA timezone with custom formatting
Retrieve Chinese official workdays, holidays, and makeup workdays for a specific month/year
Integrate time and workday queries into an MCP client for automation or productivity

Frequently asked questions

Why is the output always `text` type?

To improve MCP client compatibility, the server returns all tool results as `text` content (JSON string for workdays, plain text for time).

How does the `tz` parameter affect workday calculation?

The `tz` parameter only determines the default year/month when those arguments are omitted; it does not affect the workday logic itself (which uses local/official rules).

What does the `timeout` parameter do?

It sets the HTTP request timeout in seconds. Increase it if network fluctuations cause timeouts when fetching holiday data.

Comments

More Productivity MCP servers

JobYap

JobYap aggregates job postings directly from companies' official careers sites and gives every posting a public discussion thread, with salaries, locations and full descriptions.

TRMNL

Run your TRMNL ePaper displays from any AI agent: check on devices, plan playlists and build new screens from your own data.

SmartShifts

Copliancy Inc

Employee scheduling for multi-location teams: shifts, coverage, time off and tasks. Changes wait for approval by default, within existing role and location limits.

FlowyTeam OKR MCP Server

flowy-team

FlowyTeam is a native OKR MCP server. Connect Claude (Desktop, web, mobile), ChatGPT, Claude Code or n8n and your agent can read every objective and key result in your workspace, post check-ins, move key-result progress,

One

Connect your agent to the apps your team already uses: Gmail, Slack, Stripe, Shopify, HubSpot, Notion, Linear, Salesforce, QuickBooks and more. One hosted MCP server with OAuth sign-in, nothing to install and no API keys