Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas Iniciar sesión

MCP Jp Calendar

de skypier-jp-worksversión 1.1.0i★ 0iSe ejecuta en tu computadoraRepositorio ↗
Nombre en el registroio.github.skypier-jp-works/mcp-jp-calendar

Cómo instalar

Qué hace

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

Texto original del autor

  • Conexión Se ejecuta en tu computadora
  • Cuenta o clave No necesita clave
  • Categoría Documentos, hojas de cálculo y oficina

Úsalo junto con

Skills que enseñan a la IA este tipo de trabajo; funcionan junto a este

MinerU

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

de opendatalab★ 83.9721 skills

Skill · Guía de trabajoSin licencia indicada

watermarks-remover

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

de guillaumemeyer★ 27.7961 skills

Skill · Guía de trabajo

obsidian-skills

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

de kepano★ 53.183 (todo el repo)5 skills

Skill · Guía de trabajo

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad0/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad3/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo0/8El endpoint en la nube respondió en la última revisión
Puntuación de uso3/100

Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala MCP Jp Calendar. Sigue https://mcp.popnx.com/i/skypier-jp-works-mcp-jp-calendar.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

Que la IA lo instale

Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server MCP Jp Calendar para Claude en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "jp-calendar": { "command": "npx", "args": [ "-y", "mcp-jp-calendar" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de MCP Jp Calendar aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Abre el archivo de configuración de la app de Claude de escritorio

    SettingsDeveloperEdit Config

  3. Pega esta configuración y guarda el archivo

    {
      "mcpServers": {
        "jp-calendar": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-jp-calendar"
          ]
        }
      }
    }
  4. Cierra Claude y vuelve a abrirlo

  5. Pruébalo

    Usa MCP Jp Calendar y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando MCP Jp Calendar o muestra una herramienta de MCP Jp Calendar en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar MCP Jp Calendar

MCP Jp Calendar se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar MCP Jp Calendar

  • Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
  • Instala Node.js en tu computadora primero (una sola vez)
  • Instala Node.js en tu computadora primero (una sola vez)
  • Instala Node.js en tu computadora primero (una sola vez)

B · Otros en Documentos, hojas de cálculo y oficina que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Funciona con Claude Code, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server MCP Jp Calendar para Claude Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user jp-calendar -- npx -y mcp-jp-calendar 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de MCP Jp Calendar aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  3. Pega este comando y pulsa Enter

    claude mcp add --scope user jp-calendar -- npx -y mcp-jp-calendar
  4. Escribe /mcp en Claude Code

    Deberías ver MCP Jp Calendar en la lista como conectado

  5. Pruébalo

    Usa MCP Jp Calendar y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando MCP Jp Calendar o muestra una herramienta de MCP Jp Calendar en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server MCP Jp Calendar para Cursor en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "jp-calendar": { "command": "npx", "args": [ "-y", "mcp-jp-calendar" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de MCP Jp Calendar aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  3. Abre el chat de IA de Cursor en modo Agent

  4. Pruébalo

    Usa MCP Jp Calendar y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando MCP Jp Calendar o muestra una herramienta de MCP Jp Calendar en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server MCP Jp Calendar para VS Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "jp-calendar": { "type": "stdio", "command": "npx", "args": [ "-y", "mcp-jp-calendar" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de MCP Jp Calendar aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  3. Abre el chat de IA de VS Code en modo Agent

  4. Pruébalo

    Usa MCP Jp Calendar y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando MCP Jp Calendar o muestra una herramienta de MCP Jp Calendar en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa MCP Jp Calendar💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Instalado en tu computadora

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"
      ]
    }
  }
}

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
61/sem
Conexión
Se ejecuta en tu computadora
Última versióni
1.1.0
Publicado en el registroi
29 jul 2026
Último cambio de códigoi
31 jul 2026
Creador
skypier-jp-works
Paquetes
npm: mcp-jp-calendar
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

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

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 20 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub skypier-jp-works, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hace 4 meses

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • – No aplica

    El endpoint responde

    Este se ejecuta en tu computadora; no hay endpoint en internet

  • – No aplica

    Inicio de sesión con OAuth

    Se ejecuta en tu computadora y usa ajustes locales en su lugar

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Vulnerabilidades publicadas (OSV.dev)

Sin entradas en OSV.dev para mcp-jp-calendar@1.1.0

Solo revisa esta versión del paquete, no todas sus dependencias · revisado 16 nov 2026

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![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)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Documentos, hojas de cálculo y oficinai

  • Más estrellas que el 0% de los otros 4155 servidores de esta categoría
  • Publicado en el registro más recientemente que el 17% de los otros 4155 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 4155 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro MCP Jp Calendar?

Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 4 meses, y la última versión (1.1.0) llegó al registro hace 4 meses.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: Puter MCP, XcodeBuildMCP, Vexa, Atlassian Rovo MCP Server, Anki MCP Server

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Puter MCP

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

de HeyPuterMuy usado★ 44,2 milActualizado hace 5 meses

Se ejecuta en la nube✓ del servicio · puter.com

XcodeBuildMCP

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

de getsentryMuy usado↓ 130,5 mil/sem paquete compartido★ 6,6 milActualizado hace 4 meses

Se ejecuta en tu computadora✓ del servicio · xcodebuildmcp.com

Vexa

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

de Vexa-aiMuy usado★ 3 milActualizado hace 2 meses

Se ejecuta en la nube✓ del servicio · vexa.ai

Atlassian Rovo MCP Server

Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.

de atlassianEn crecimiento★ 1,2 milActualizado hace 2 meses

Se ejecuta en la nube✓ del servicio · atlassian.com

Anki MCP Server

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

de ankimcpEn crecimiento↓ 1,1 mil/sem★ 570Actualizado hace 2 meses

Se ejecuta en tu computadora✓ del servicio · ankimcp.ai
Comparado con otros parecidos
Este
MCP Jp Calendar
Puter MCPXcodeBuildMCPVexaAtlassian Rovo MCP ServerAnki MCP Server
Dónde se ejecutaSe instala en tu equipoFunciona en la nube, sin instalar nadaSe instala en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaSe instala en tu equipo
Necesita claveNoNoNoSíNoNo
Se añade con + en ClaudeNoNoNoNoSíNo
Revisiones básicas3/34/43/32/44/43/3
LicenciaMITAGPL-3.0MITApache-2.0Apache-2.0MIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

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