NannyKeeper Household Payroll & Taxes — Claude Code MCP server
Computes US household employment taxes and handles payroll across all 50 states and DC directly inside your AI agent chat.
claude mcp add mcp-server -e NANNYKEEPER_API_KEY=<NANNYKEEPER_API_KEY> -- npx -y @nannykeeper/mcp-serverWhat NannyKeeper Household Payroll & Taxes does
This server connects your AI assistant to the NannyKeeper API to calculate household employer obligations across all 50 states plus DC. Instead of guessing percentages, the model receives exact 2026 figures for Social Security, Medicare, FUTA, state unemployment, and regional deductions.
Four tools are exposed: calculate_nanny_taxes for itemised breakdowns, check_threshold to verify if wages trigger legal reporting rules, preview_payroll for dry runs without database writes, and run_payroll to record paychecks with cumulative year-to-date tracking.
An API key in NANNYKEEPER_API_KEY is mandatory before starting the server. The free tier gives 50 requests daily for tax estimates, while saving actual payroll records through run_payroll requires a paid Starter plan or higher.
What it helps with
- determine if household wages cross federal and state filing thresholds
- calculate exact employer and employee FICA and FUTA tax shares by state
- dry-run a nanny paycheck breakdown without writing to a database
- record periodic payroll with cumulative year-to-date tracking
Example prompts for the agent
- Check if paying $2,500 in California triggers household employer taxes using
check_threshold - Calculate complete federal and state nanny taxes for $35,000 annual wages in NY
- Run
preview_payrollfor biweekly pay in Texas without persisting data
How to install NannyKeeper Household Payroll & Taxes
Platform CLI
claude mcp add mcp-server -e NANNYKEEPER_API_KEY=<NANNYKEEPER_API_KEY> -- npx -y @nannykeeper/mcp-serverReplace <…> with your own values
Platform CLI
codex mcp add nannykeeper-household-payroll-taxes --env NANNYKEEPER_API_KEY=<NANNYKEEPER_API_KEY> -- npx -y @nannykeeper/mcp-serverReplace <…> with your own values
Config file
{
"mcpServers": {
"nannykeeper-household-payroll-taxes": {
"command": "npx",
"args": [
"-y",
"@nannykeeper/mcp-server"
],
"env": {
"NANNYKEEPER_API_KEY": "<NANNYKEEPER_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"nannykeeper-household-payroll-taxes": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@nannykeeper/mcp-server"
],
"env": {
"NANNYKEEPER_API_KEY": "<NANNYKEEPER_API_KEY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e NANNYKEEPER_API_KEY=<NANNYKEEPER_API_KEY> nannykeeper-household-payroll-taxes npx -y @nannykeeper/mcp-serverReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about NannyKeeper Household Payroll & Taxes
How do I install NannyKeeper Household Payroll & Taxes in Claude Code?
Run claude mcp add --env NANNYKEEPER_API_KEY=<NANNYKEEPER_API_KEY> --transport stdio nannykeeper-household-payroll-taxes -- npx -y @nannykeeper/mcp-server. Replace the placeholder with your actual API key.
What does NannyKeeper Household Payroll & Taxes do?
It enables AI agents to compute US household employer taxes across all 50 states and execute payroll workflows via API tools.
Is a paid subscription required to calculate taxes?
No, calculating taxes and checking wage thresholds is supported on the free plan with a limit of 50 requests per day. The paid Starter plan is only required to run run_payroll with persistent records.
