mcpbeat Sign in

Shikamaru MCP Server

local only

Shikamaru runs on your own machine — the client starts it, so there is no endpoint to ping. 54 installs a week from npm. Last commit 2 Aug 2026.

Provably correct day-count, calendar, business-day, and schedule math, verified against QuantLib.

Installs per day peak 15 · avg 5 · +218% w/w
a month agotoday
54
Installs / week
npm · @jayofemi/shikamaru
1
Stars
0 open issues
2 Aug 2026
Last commit
no releases in 90 days
MIT
License
TypeScript

Nothing serious here today

Today is the operative word: we check Shikamaru every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add shikamaru -- npx -y @jayofemi/shikamaru
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "shikamaru": {
      "command": "npx",
      "args": [
        "-y",
        "@jayofemi/shikamaru"
      ]
    }
  }
}
~/.codex/config.toml
[mcp_servers.shikamaru]
command = "npx"
args = ["-y", "@jayofemi/shikamaru"]
.cursor/mcp.json
{
  "mcpServers": {
    "shikamaru": {
      "command": "npx",
      "args": [
        "-y",
        "@jayofemi/shikamaru"
      ]
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "shikamaru": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@jayofemi/shikamaru"
      ]
    }
  }
}

Alternatives to Shikamaru

same job, measured the same way
Bizdays
by qinisolabs

Verified business-day math for AI agents: holidays + per-country weekends, not guesses.

49 installs/wk local only
Workday Calendar
by workers-regnotes-workday-calendar

Public holidays and business-day math (T+N, counts) for many countries; pay per call via x402

4 tools answering
Canada Business Calendar MCP
by donniertf-hub

Canadian federal and provincial holidays, business-day maths and invoice due dates.

4 tools answering
Date Math MCP
by mrfentmen

Business-day counting, date shifting and calendar differences with holiday support - fully local.

497 installs/wk local only
QECTOR Quantum Error Correction
by guillaumelessard

Local quantum error correction tools; decoder output verified against H c = s (mod 2).

local only
World Business Calendar
by groove79

Public holidays and working-day math for 200+ countries and regions, local weekends. No keys.

296 installs/wk local only
Project Management Validation
by antnewman

Validate project data against NISTA standards, scheduling best practices, and custom rules

148 installs/wk local only
Klass Personal OS
by klassycoder

Mac app that runs Claude or Codex on a schedule against your mail, calendar, and files.

local only

Shikamaru — questions

Answers built from our own checks of this server.

Why is there no uptime for Shikamaru?
Shikamaru runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package @jayofemi/shikamaru was installed 54 times last week.
How do I connect Shikamaru?
Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls @jayofemi/shikamaru straight from npm; nothing to host, nothing to sign up for.
How many people use Shikamaru?
The npm package @jayofemi/shikamaru was installed 54 times in the last week. Week over week that is +218%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Shikamaru open source?
Yes — it is published under the MIT licence, written in TypeScript and 1 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.