Skip to content
MCP server

ベストカレンダー 暦データ

Japanese calendar data from 1926 to 2080 with official-value checks and sources

Install
Pricing
Free
Platforms
API
Runs
Remotely
Version
1.0.0
Listing updated
2 days ago

About ベストカレンダー 暦データ

ベストカレンダー 暦データ is a free MCP server for productivity. It runs as a hosted remote server, so there is nothing to install locally.

This server answers questions about the Japanese almanac: rokuyo, lucky days such as ichiryumanbai and tenshanichi, the old lunar calendar, the 24 solar terms down to the exact time, holidays and substitute holidays, era names, zodiac and nine-star signs, moon phases, eclipses and sunrise and sunset by prefecture. It also counts days and business days, skipping weekends and holidays.

There are 16 tools, including one that reads a Japanese question and returns an answer with the tool and arguments used. Every result carries sources, an explanation of how it was checked against National Astronomical Observatory of Japan and Cabinet Office figures, and a page URL for verification. Lucky days have no official reference table, so their rules were recomputed independently and compared.

It is free, needs no sign-in and is read-only. Limits are 60 calls a minute and 3,000 a day per source, searches return up to 200 results and periods up to 366 days. The site is in Japanese, and the data is offered without warranty.

Install

Run in a terminal

claude mcp add --transport http koyomi https://bestcalendar.jp/mcp

Add to Settings → Connectors → Add custom connector

https://bestcalendar.jp/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "koyomi": {
      "url": "https://bestcalendar.jp/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "koyomi": {
      "type": "http",
      "url": "https://bestcalendar.jp/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "koyomi": {
      "serverUrl": "https://bestcalendar.jp/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "koyomi": {
      "type": "http",
      "url": "https://bestcalendar.jp/mcp"
    }
  }
}

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

get_koyomi_day
Returns calendar data for one day, including rokuyo, lucky days, moon, holiday and nine-star values.

What it does

Rokuyo and lucky days
Look up auspicious day types for any date.
Solar terms and moon
Exact term times, new and full moon moments and eclipses.
Holiday data
Holidays and substitute holidays checked against official figures.
Business-day math
Count or offset days while skipping holidays.
Date search
Find days matching combined calendar conditions.
Cited results
Each answer includes sources and a verification URL.

Good for

  • Find a taian falling on a weekend
  • Get an equinox or solstice time
  • List a year's public holidays
  • Compute a deadline 10 business days out
  • Convert a birth year to era and nine star

Pricing

Free

Free and no registration; commercial API for businesses is separate

Prices change. Check bestcalendar.jp before you buy.

ベストカレンダー 暦データ FAQ

Is it free?

Yes, with no sign-in or API key.

What dates are covered?

1 January 1926 to 31 December 2080; holidays start from 1948.

Are there rate limits?

60 calls per minute and 3,000 per day per source.

Where do the figures come from?

National Astronomical Observatory of Japan and the Cabinet Office, with the check explained in results.

Is ベストカレンダー 暦データ free?

Yes. ベストカレンダー 暦データ is free to use.

How do I add ベストカレンダー 暦データ to Claude Code?

Run this command in your terminal: claude mcp add --transport http koyomi https://bestcalendar.jp/mcp

What are the best alternatives to ベストカレンダー 暦データ?

The closest alternatives to ベストカレンダー 暦データ are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.

Alternatives to ベストカレンダー 暦データ

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  5. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  6. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media