Nannykeeper MCP server
{
"mcpServers": {
"nannykeeper": {
"command": "npx",
"args": [
"-y",
"@nannykeeper/mcp-server@latest"
],
"env": {
"NANNYKEEPER_API_KEY": "<nannykeeper_api_key>"
}
}
}
}{
"mcpServers": {
"nannykeeper": {
"command": "npx",
"args": [
"-y",
"@nannykeeper/mcp-server@latest"
],
"env": {
"NANNYKEEPER_API_KEY": "<nannykeeper_api_key>"
}
}
}
}{
"mcpServers": {
"nannykeeper": {
"command": "npx",
"args": [
"-y",
"@nannykeeper/mcp-server@latest"
],
"env": {
"NANNYKEEPER_API_KEY": "<nannykeeper_api_key>"
}
}
}
}{
"servers": {
"nannykeeper": {
"command": "npx",
"args": [
"-y",
"@nannykeeper/mcp-server@latest"
],
"env": {
"NANNYKEEPER_API_KEY": "${input:nannykeeper_api_key}"
}
}
},
"inputs": [
{
"id": "nannykeeper_api_key",
"type": "promptString",
"description": "Nannykeeper api key",
"password": true
}
]
}{
"mcpServers": {
"nannykeeper": {
"command": "npx",
"args": [
"-y",
"@nannykeeper/mcp-server@latest"
],
"env": {
"NANNYKEEPER_API_KEY": "<nannykeeper_api_key>"
}
}
}
}file .mcp.json (in your project root)file claude_desktop_config.jsonfile ~/.cursor/mcp.jsonfile .vscode/mcp.jsonfile ~/.codeium/windsurf/mcp_config.jsoninstall npx -y @nannykeeper/mcp-serverversion 1.10.2
What it does
MCP server that exposes the NannyKeeper API for calculating US household employer (nanny) taxes across all 50 states and DC. It lets AI agents retrieve exact tax calculations, check employment thresholds, preview payroll, and run payroll with persistent tracking.
- Ask Claude or other AI assistants about nanny tax obligations and get state-specific federal + state tax breakdowns instead of rough estimates.
- Check whether wages for a household employee trigger tax filing requirements based on state-specific thresholds that vary from $500 to $3,000 per year.
- Run payroll for household employees with automatic YTD tracking and optional direct deposit, generating W-2s and pay stubs.
Tools this server exposes
| Tool | Does |
|---|---|
| calculate_nanny_taxes | Returns federal and state tax breakdown (Social Security, Medicare, FUTA, state unemployment, state income tax, SDI, PFL, local taxes) for a given state, annual |
| check_threshold | Determines whether wages meet the household employer tax filing threshold, which varies by state from $500 to $3,000 per year. |
| preview_payroll | Dry-run a payroll calculation without writing to the database, showing per-paycheck costs and deductions. |
| run_payroll | Execute payroll end-to-end with YTD tracking and database persistence, including optional direct deposit for pay dates more than 5 business days out. |
Before you enable it
An MCP server runs with whatever access you give it. Start with a development account rather than production, and check which tools the server exposes before you let an agent call them unattended.