プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説 ログイン

MCP Jp Calendar

作者:skypier-jp-worksバージョン 1.1.0i★ 0iパソコンで動くリポジトリ ↗
レジストリ名io.github.skypier-jp-works/mcp-jp-calendar

インストール方法

できること

MCP server for Japanese business days, holidays, and fiscal-period calculations.

作者による原文

  • 接続方法 パソコンで動く
  • アカウントまたはキー キー不要
  • カテゴリ 文書・表計算・事務作業

一緒に使える

この種の作業を AI に教える Skill。これと一緒に使えます

MinerU

Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.

作者:opendatalab★ 83,9721 個の skill

Skill · 手順書ライセンス記載なし

watermarks-remover

A privacy-first app that strips AI watermarks from content you own.

作者:guillaumemeyer★ 27,7961 個の skill

Skill · 手順書

obsidian-skills

Agent skills for Obsidian. Teach your agent to use Obsidian CLI and open formats including Markdown, Bases, JSON Canvas.

作者:kepano★ 53,183 (リポジトリ全体)5 個の skill

Skill · 手順書

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気0/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ3/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア3/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

MCP Jp Calendar をインストールして。https://mcp.popnx.com/i/skypier-jp-works-mcp-jp-calendar.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月14日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

AI にインストールしてもらう

このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude に MCP server MCP Jp Calendar を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "jp-calendar": { "command": "npx", "args": [ "-y", "mcp-jp-calendar" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、MCP Jp Calendar のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  3. この設定を貼り付けて保存

    {
      "mcpServers": {
        "jp-calendar": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-jp-calendar"
          ]
        }
      }
    }
  4. Claude を終了してもう一度開く

  5. 試してみる

    MCP Jp Calendar を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が MCP Jp Calendar を使っていると言うか、回答に MCP Jp Calendar のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ MCP Jp Calendar につなげません

MCP Jp Calendar はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · MCP Jp Calendar につなげるアプリを使う

  • 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • 先にパソコンへ Node.js を入れてください(1 回だけ)
  • 先にパソコンへ Node.js を入れてください(1 回だけ)
  • 先にパソコンへ Node.js を入れてください(1 回だけ)

B · 文書・表計算・事務作業 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude Code に MCP server MCP Jp Calendar を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user jp-calendar -- npx -y mcp-jp-calendar 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、MCP Jp Calendar のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  3. このコマンドを貼り付けて Enter

    claude mcp add --scope user jp-calendar -- npx -y mcp-jp-calendar
  4. Claude Code で /mcp と入力

    MCP Jp Calendar が一覧にあり、接続済みと表示されれば OK です

  5. 試してみる

    MCP Jp Calendar を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が MCP Jp Calendar を使っていると言うか、回答に MCP Jp Calendar のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Cursor に MCP server MCP Jp Calendar を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "jp-calendar": { "command": "npx", "args": [ "-y", "mcp-jp-calendar" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、MCP Jp Calendar のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  3. Cursor の AI チャットを Agent モードで開く

  4. 試してみる

    MCP Jp Calendar を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が MCP Jp Calendar を使っていると言うか、回答に MCP Jp Calendar のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの VS Code に MCP server MCP Jp Calendar を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "jp-calendar": { "type": "stdio", "command": "npx", "args": [ "-y", "mcp-jp-calendar" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、MCP Jp Calendar のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  3. VS Code の AI チャットを Agent モードで開く

  4. 試してみる

    MCP Jp Calendar を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が MCP Jp Calendar を使っていると言うか、回答に MCP Jp Calendar のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?MCP Jp Calendar を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user jp-calendar -- npx -y mcp-jp-calendar

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "jp-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-jp-calendar"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "jp-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-jp-calendar"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "jp-calendar": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-jp-calendar"
      ]
    }
  }
}

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
61/週
接続方法
パソコンで動く
最新バージョンi
1.1.0
レジストリ公開日i
2026年7月29日
コードの最終更新i
2026年7月31日
作者
skypier-jp-works
パッケージ
npm: mcp-jp-calendar
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月20日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント skypier-jp-works で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:4 か月前

  • ✓ 合格

    ライセンスがある

    MITを使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

OSV.dev に mcp-jp-calendar@1.1.0 の登録はありません

このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月16日

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/skypier-jp-works-mcp-jp-calendar.svg)](https://mcp.popnx.com/en/servers/skypier-jp-works-mcp-jp-calendar)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

文書・表計算・事務作業のほかのサーバーとの比較i

  • このカテゴリのほかの4155件のうち0%よりスターが多い
  • このカテゴリのほかの4155件のうち17%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの4155件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

MCP Jp Calendarは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は4 か月前、最新バージョン(1.1.0)がレジストリに届いたのは4 か月前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは?

同じカテゴリには:Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

Puter MCP

Puter MCP enables AI tools to interact with Puter: manage files, websites, workers, and more

作者:HeyPuter広く使われている★ 4.4万5 か月前更新

クラウドで動く✓ 提供元 · puter.com

XcodeBuildMCP

XcodeBuildMCP provides tools for Xcode project management, simulator management, and app utilities.

作者:getsentry広く使われている↓ 13万/週 共有パッケージの数★ 65944 か月前更新

パソコンで動く✓ 提供元 · xcodebuildmcp.com

Vexa

Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.

作者:Vexa-ai広く使われている★ 29972 か月前更新

クラウドで動く✓ 提供元 · vexa.ai

Anki MCP Server

MCP server for Anki flashcards: adaptive review, notes, media, and deck management via AnkiConnect.

作者:ankimcp成長中↓ 1136/週★ 5702 か月前更新

パソコンで動く✓ 提供元 · ankimcp.ai
似たものと比べる
これ
MCP Jp Calendar
Puter MCPXcodeBuildMCPVexaAtlassian Rovo MCP ServerAnki MCP Server
動く場所パソコンにインストールが必要クラウドで動き、インストール不要パソコンにインストールが必要クラウドで動き、インストール不要クラウドで動き、インストール不要パソコンにインストールが必要
キーが必要いいえいいえいいえはいいいえいいえ
Claude で + から追加いいえいいえいいえいいえはいいいえ
基本チェック3/34/43/32/44/43/3
ライセンスMITAGPL-3.0MITApache-2.0Apache-2.0MIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

mcp-jp-calendar

日本語版はこちら (Japanese README)

Give your AI agent correct answers about Japanese business days. An MCP server that tells Claude (or any MCP client) whether a date is a working day in Japan, what date payment is actually due, and which fiscal quarter you're in — accounting for national holidays, substitute holidays, and conventions no simple weekday check gets right. No API keys, no network calls: all holiday data (2020–2030) is embedded in the package.

Contents

  • Why this exists
  • Install
  • Tools
  • Supported range & data source
  • The meta field
  • Versioning policy
  • Maintenance policy
  • Disclaimer
  • Development
  • Related tools

Why this exists

A naive "is it a weekday" check gets Japanese business dates wrong more often than you'd expect. A few real examples this server handles correctly:

SituationNaive weekday checkWhat actually happens
Substitute holiday (振替休日)Children's Day, May 5 2026, falls on a Sunday → looks like the next day (Mon May 6) is a normal business dayMay 6 2026 is *also* a public holiday — Japanese law shifts the holiday to the next non-holiday day
Citizens' holiday (国民の休日)Sep 22 2026 is a Tuesday, sandwiched between two holidays → looks like a business dayIt's a holiday too: when a weekday falls between two national holidays, it automatically becomes one
Gotobi settlement days (五十日)Japanese invoices and payments conventionally settle on the 5th/10th/15th/20th/25th/month-end — irrelevant in most other countriesnext_gotobi finds the next one and, if it lands on a holiday, tells you the actual (pushed-back) business day payment will clear
Fiscal year (年度)December looks like Q4 if you assume a January-start yearMost Japanese companies run an April–March fiscal year, so December is actually Q3

Get any of these wrong in a scheduling or invoicing agent and you'll pick a bank holiday as a due date, or misreport a quarter. This server encodes the actual rules so your agent doesn't have to guess.

Install

Option 1 — npx (recommended)

No install step required. Add this to your Claude Desktop config (claude_desktop_config.json):

  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{

"mcpServers": { "jp-calendar": { "command": "npx", "args": ["-y", "mcp-jp-calendar"] } } }

Restart Claude Desktop and the tools become available. You can also run it directly:

npx mcp-jp-calendar

Or install it globally:

npm install -g mcp-jp-calendar
Option 2 — .mcpb bundle (one-click install for Claude Desktop)

MCP Bundles let you install a local MCP server with a single double-click, no terminal required. Build one from source:

git clone https://github.com/skypier-jp-works/mcp-jp-calendar.git

cd mcp-jp-calendar npm install npm run build mkdir -p mcpb-dist/server && cp build/*.js mcpb-dist/server/ cd mcpb-dist npm install --omit=dev npm install -g @anthropic-ai/mcpb mcpb pack . mcp-jp-calendar.mcpb

Then double-click the resulting mcp-jp-calendar.mcpb file to install it in Claude for macOS/Windows.

Tools

All dates are given and returned in YYYY-MM-DD format (e.g. 2026-08-15). month_end_info takes a YYYY-MM month string (e.g. 2026-08).

ToolDescription
is_business_dayCheck whether a given date is a business day
add_business_daysGet the date N business days after/before a given date
count_business_daysCount business days between two dates (inclusive)
next_gotobiGet the next "gotobi" settlement day (5th, 10th, 15th, 20th, 25th, or last day of month), plus the actual business day if that date is a holiday
month_end_infoGet the last day of a given month, and the effective closing date if that day is a holiday
fiscal_periodDetermine which fiscal year and quarter a date falls in (fiscal year start month is configurable; defaults to April)
list_holidaysList Japan's national holidays for a given year

All of is_business_day, add_business_days, count_business_days, next_gotobi, and month_end_info accept two optional parameters:

  • weekendDays: array of weekday numbers to treat as non-working days. 0=Sun … 6=Sat. Defaults to [0, 6].
  • customHolidays: array of YYYY-MM-DD strings for company-specific closures (e.g. a year-end shutdown).
Examples

`is_business_day` — a Saturday:

// Request: { "date": "2026-08-15" }

{ "date": "2026-08-15", "isBusinessDay": false, "reason": "土曜日" }

`add_business_days` — 1 business day after a Friday:

// Request: { "date": "2026-07-24", "businessDays": 1 }

{ "startDate": "2026-07-24", "businessDays": 1, "resultDate": "2026-07-27" }

`count_business_days` — a full Mon–Sun week:

// Request: { "startDate": "2026-07-27", "endDate": "2026-08-02" }

{ "startDate": "2026-07-27", "endDate": "2026-08-02", "businessDays": 5 }

`next_gotobi` — the 15th falls on a Saturday, so it's pushed back:

// Request: { "date": "2026-08-11" }

{ "gotobiDate": "2026-08-15", "isBusinessDay": false, "actualDate": "2026-08-14" }

`month_end_info` — month-end falls on a Sunday:

// Request: { "yearMonth": "2027-01" }

{ "yearMonth": "2027-01", "monthEndDate": "2027-01-31", "isBusinessDay": false, "actualClosingDate": "2027-01-29" }

`fiscal_period` — December, under Japan's standard April-start fiscal year:

// Request: { "date": "2026-12-01" }

{ "date": "2026-12-01", "fiscalYearStartMonth": 4, "fiscalYear": 2026, "quarter": 3 }

`list_holidays` — excerpt showing a citizens' holiday (国民の休日):

// Request: { "year": 2026 }

{ "year": 2026, "holidays": [ { "date": "2026-09-21", "name": "敬老の日" }, { "date": "2026-09-22", "name": "国民の休日" }, { "date": "2026-09-23", "name": "秋分の日" } ] }

(Examples above are abbreviated for readability — every response also includes a meta field; see The meta field.)

Supported range & data source

Only dates from 2020 to 2030 are supported. Dates outside this range return an error.

  • Holiday data for 2020–2027 is confirmed, sourced directly from Japan's Cabinet Office (内閣府) official holiday CSV: https://www8.cao.go.jp/chosei/shukujitsu/gaiyou.html
  • Holiday data for 2028–2030 is a computed estimate: the vernal/autumnal equinox holidays (春分の日 / 秋分の日) aren't officially announced that far ahead, so they're calculated with the standard astronomical approximation formula and may differ from the eventual official announcement by up to a day.
  • The 2020/2021 Tokyo Olympics special holiday moves (Marine Day, Sports Day, Mountain Day) are included.
  • Substitute holidays (振替休日) and citizens' holidays (国民の休日) are computed automatically and have been cross-checked against the official Cabinet Office data for 2020–2027.

The meta field

Every tool response includes a meta block alongside the actual result:

"meta": {

"dataVerifiedOn": "2026-07-28", "sources": [{ "label": "Cabinet Office official holiday CSV", "url": "https://..." }], "staleWarning": null }

  • dataVerifiedOn: the date this server's holiday data was last checked against the primary source.
  • sources: the source(s) backing this response (fiscal_period doesn't use holiday data at all, so its sources is an empty array).
  • staleWarning: a bilingual (Japanese/English) warning when more than 6 months have passed since dataVerifiedOn; null otherwise.

Dates outside the supported range (2020–2030) still return a hard error rather than a warning, since no data exists for those dates at all.

Versioning policy

  • Any update to the embedded holiday data bumps the minor version (e.g. 1.1.0 → 1.2.0). Patch versions are reserved for bug fixes and documentation.
  • Changes are recorded in CHANGELOG.md, noting when and what was updated.

Maintenance policy

  • The maintainer intends to update src/holidays.ts whenever the Public Holiday Act is amended or the Cabinet Office publishes updated data. Since this server never makes network calls at runtime, reflecting a change requires a manual update.
  • If you're aware of a holiday change (new/moved/removed holiday), please report it via GitHub Issues: https://github.com/skypier-jp-works/mcp-jp-calendar/issues
  • For anything important, check meta.dataVerifiedOn and meta.staleWarning, and confirm against the latest Cabinet Office announcement if needed.

Disclaimer

  • The accuracy of this tool's calculations is not guaranteed.
  • Actual business days and closing dates are governed by each company's own work rules and by agreements with business partners, which always take precedence over this tool's output.
  • If you are using this tool for any important business decision, you must independently verify the results yourself.

Development

Clone and build from source if you want to modify the server:

git clone https://github.com/skypier-jp-works/mcp-jp-calendar.git

cd mcp-jp-calendar npm install npm run build # compiles src/ -> build/ npm test # 38 tests covering all 7 tools

Claude Desktop config for a locally built copy:

{

"mcpServers": { "jp-calendar": { "command": "node", "args": ["/absolute/path/to/mcp-jp-calendar/build/index.js"] } } }

Project structure
mcp-jp-calendar/

├── src/ │ ├── holidays.ts # Embedded holiday data for 2020-2030 (Cabinet Office data + estimates) │ ├── dataMeta.ts # Data-verification date, sources, and staleness-warning helpers │ ├── dateUtils.ts # Core logic: business days, closing dates, fiscal periods, etc. │ └── index.ts # MCP server entry point (exposes the 7 tools) ├── tests/ │ ├── dateUtils.test.ts │ └── dataMeta.test.ts ├── mcpb-dist/ │ └── manifest.json # MCP Bundle (.mcpb) manifest — see Install, Option 2 ├── package.json ├── tsconfig.json ├── CHANGELOG.md # Record of holiday-data updates and spec changes ├── LICENSE ├── README.md # this file └── README.ja.md # Japanese version

If a holiday law changes, this server's embedded data will not update automatically — src/holidays.ts needs to be updated manually.

Related tools

Other MCP servers by the same author:

  • mcp-jp-paid-leave — calculates Japanese statutory annual paid leave (entitlement grants, attendance-rate checks, proportional grants, carryover, the 5-day mandatory-use rule, and more)
  • mcp-jp-corporate-id — validates and normalizes Japanese corporate numbers and qualified invoice registration numbers

License

MIT