How do I set up the NannyKeeper MCP server?
The NannyKeeper MCP server lets AI agents like Claude and ChatGPT calculate household employer taxes for all 50 US states during conversations. Install takes 30 seconds: get a free API key, add the config below, and you're done.
Get a free API key
You need an API key to authenticate requests. The free tier gives you 50 calculations per day — no credit card required.
Get API KeyAdd to Claude Desktop
Open your Claude Desktop config file and add the NannyKeeper server. Replace nk_live_YOUR_KEY with your actual API key.
// Add to your Claude Desktop config file:
// macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
// Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"nannykeeper": {
"command": "npx",
"args": ["@nannykeeper/mcp-server"],
"env": {
"NANNYKEEPER_API_KEY": "nk_live_YOUR_KEY"
}
}
}
}Start a conversation
Restart Claude Desktop, then ask about nanny taxes. Claude will call NannyKeeper's tools to give a specific, line-by-line breakdown.
You: "How much would I owe in taxes if I pay my nanny
$35,000 per year in California?"
Claude: [calls calculate_nanny_taxes tool]
"Based on NannyKeeper's calculation, here's your breakdown
for a $35,000/year employee in California:
Employer taxes (your cost):
Social Security: $2,170.00
Medicare: $507.50
FUTA: $42.00
CA Unemployment: $119.00
Total: $2,838.50/year ($109.17/paycheck biweekly)
Your total cost per paycheck: $1,455.94
($1,346.15 gross pay + $109.17 employer taxes)
This exceeds the $3,000 FICA threshold, so you are a
household employer and must file Schedule H."Available tools
calculate_nanny_taxesCalculate employer and employee tax obligations for a household employee in any US state. Returns Social Security, Medicare, FUTA, state unemployment, income tax, and per-paycheck breakdown.
| state | string | 2-letter US state code (e.g., CA, NY) |
| annual_wages | number | Annual wages paid to the employee |
| pay_frequency | string | weekly, biweekly, semimonthly, or monthly |
check_thresholdCheck if annual wages cross the IRS household employer threshold ($3,000 for 2026) and any state-specific thresholds.
| state | string | 2-letter US state code |
| annual_wages | number | Annual wages to check |
| tax_year | number | Tax year (default: current year) |
Works with other MCP clients too
The server uses standard stdio transport. Any MCP-compatible client works — not just Claude Desktop. Same config pattern: point the client at npx @nannykeeper/mcp-server with your API key in the environment.
Need more than calculations?
The free tier covers tax calculations. Upgrade to run payroll, generate pay stubs and W-2s, and process direct deposit — all via the same API.
View API pricing