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ステップ
- 無料キー登録でアカウントを作る(ログインしなくても使えます/キーの管理は /dashboard/)
- 下のコマンドで MCP サーバーを追加する(接続先URL:
https://jp-calendar.plugrail.dev/mcp) - AI エージェントに上の「人間の聞き方」の質問を投げる
Claude Code の場合は、ターミナルで次のコマンドを実行します。
claude mcp add --transport http jp-calendar https://jp-calendar.plugrail.dev/mcp 料金と上限
無料ではじめる
匿名で無料利用できます。月次の呼び出し上限はなく、登録なしでも使えます(カード不要)。
- 短時間の集中利用には分あたりの上限があります。
- SLA は設けていません。
質問
よくある質問
-
土日は祝日ですか
土日自体は祝日ではありません。
is_holidayのis_weekendで土日かどうかが分かります。 -
祝日名も返りますか
holiday_nameに祝日名が返ります。祝日でない場合はnullです。 -
year を文字列で渡せますか
いいえ。
yearは数値で指定してください("2026"は使えません)。 -
year と from/to を同時に指定できますか
できません。
yearかfromとtoのペアか、どちらか一方で指定してください。 -
期間はどれくらい指定できますか
最大5年までです。それより長い期間は分割して指定してください。
-
収録範囲にない日付を指定するとどうなりますか
out_of_data_range で返します。将来の年のように収録範囲にない日付の判定結果は返しません。
注意
ご利用前に
- 元データは内閣府「国民の祝日について」の公表情報です。本サービスは内閣府の公式サービスではありません。
- データの収録範囲外の日付・期間は 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回聞いてみてください。キー登録は後からでもできます。