jp-calendar 祝日 API 無料

祝日 API を、自前データなしで使う

日本の祝日を、AI エージェントにそのまま聞けます。内閣府の公表データを取り込んでいるため、祝日リストを自分で持ったり、毎年更新したりする必要はありません。

できること

祝日 API でできること

祝日かどうかを判定する

is_holiday は指定日が祝日かどうかを判定します。is_holiday(真偽)と holiday_name(祝日名)に加えて、weekday(曜日)と is_weekend(土日かどうか)も一緒に返します。土日自体は祝日ではありません。

例: is_holiday {"date": "2026-01-01"}

年・期間で一覧を返す

list_holidays は {"year": 2026} または {"from": "2026-01-01", "to": "2026-06-30"} のどちらかで指定します。両方を同時に指定することはできません。year は数値で指定し、文字列の "2026" は使えません。期間は最大5年までです。

土日・銀行休業日の扱い

土日かどうかは is_holiday の is_weekend で分かります。土日は祝日ではありません。銀行休業日(12/31〜1/3)も除外した営業日が知りたい場合は、add_business_days に calendar="banking" を指定してください。営業日かどうかだけを知りたいときは add_business_days(days=0 でも可)でも調べられます。

is_holiday     {"date":"2026-01-01"}          # 祝日かどうか+曜日+土日判定
list_holidays  {"year":2026}                  # 年別の一覧
list_holidays  {"from":"2026-01-01","to":"2026-06-30"}

人間の聞き方:
「2026-01-01 は祝日?」
「2026 年の祝日一覧を出して」
「2026-01-01 から 2026-06-30 までの祝日を教えて」

他の祝日 API との違い

他の祝日 API との違い

内閣府の公表データ

内閣府「国民の祝日について」の公表データを取り込んでいます。祝日の一覧をシートに貼り付けて毎年保守する必要はありません。

出典が必ず付く

返答には必ず「出典: 内閣府「国民の祝日について」… を加工して作成」が付きます。AI エージェントの答えをうのみにせず、出典元で確かめられます。

日本の振替休日・国民の休日に対応

公表データには振替休日や国民の休日も含まれます。祝日法による移動・発生も、データのまま照会できます。

返答の根拠

返答には出典が付きます

出典: 内閣府「国民の祝日について」(https://www8.cao.go.jp/chosei/shukujitsu/gaiyou.html )を加工して作成。本サービスは内閣府の公式サービスではありません。

すべての返答に出典が付きます。重要な判断では一次情報も確認してください。

つなぎ方

接続は3ステップ

  1. 無料キー登録でアカウントを作る(ログインしなくても使えます/キーの管理は /dashboard/)
  2. 下のコマンドで MCP サーバーを追加する(接続先URL: https://jp-calendar.plugrail.dev/mcp)
  3. AI エージェントに上の「人間の聞き方」の質問を投げる

Claude Code の場合は、ターミナルで次のコマンドを実行します。

claude mcp add --transport http jp-calendar https://jp-calendar.plugrail.dev/mcp

料金と上限

無料ではじめる

匿名で無料利用できます。月次の呼び出し上限はなく、登録なしでも使えます(カード不要)。

  • 短時間の集中利用には分あたりの上限があります。
  • SLA は設けていません。

質問

よくある質問

注意

ご利用前に

  • 元データは内閣府「国民の祝日について」の公表情報です。本サービスは内閣府の公式サービスではありません。
  • データの収録範囲外の日付・期間は out_of_data_range で返します。将来の年のように収録範囲にない日付の判定結果は返しません。
  • 祝日や営業日の確認を手早く済ませるためのサービスです。大事な判断では、公表サイトの原本もあわせて確かめてください。
  • 出典: 内閣府「国民の祝日について」(https://www8.cao.go.jp/chosei/shukujitsu/gaiyou.html )を加工して作成。
  • 利用記録は収集から90日で削除します。

営業日の計算については営業日 計算 API のページもあります。

エラーが出たとき

よくあるエラーと対処

返ってくる内容 原因 対処
HTTP 401「認証に失敗しました。」 APIキーの形式が違うか、失効している 管理画面でキーを確かめ、Authorization: Bearer <キー> で送り直す。
HTTP 429「レート制限を超過しました。」 1分あたりの上限(ログインなし10回・無料60回・プロ600回)に達した 返ってきた Retry-After の秒数だけ待って再試行する
invalid_input 番号の桁が足りないなど、入力の形が違う ページ上部の入力例の形に合わせる
out_of_data_range 収録範囲外の日付 収録範囲内の日付で問い合わせる

まず動くか確かめる(curl)

curl -s https://jp-calendar.plugrail.dev/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

ツールの一覧が返れば接続はできています。

次の一歩

まず1回、登録なしで聞いてみる

無料の祝日 API を探しているなら、まず接続先 URL を追加して1回聞いてみてください。キー登録は後からでもできます。