NannyKeeper Household Payroll & Taxes
Connects Claude to the NannyKeeper API for calculating household employer taxes across all 50 states. Exposes four tools: calculate_nanny_taxes for full federal and state breakdowns, check_threshold to see if wages trigger tax obligations, preview_payroll for dry runs, and run_payroll for end-to-end processing with YTD tracking. Handles the messy state-by-state rules for Social Security, Medicare, FUTA, unemployment, and income tax withholding. Useful if you're building family finance tools, managing payroll for household employers, or just want Claude to stop guessing at nanny tax math. Free tier covers calculations, paid plans add W-2 generation and direct deposit.
- tools
- 4
- auth
- Secret needed
- transport
- STDIO
- env var
- 1
- last updated
- Nov 10, 2026
Tools
4 toolsPublic tool metadata for what this MCP can expose to an agent.
calculate_nanny_taxesFull federal + state tax breakdown for any US state.
Full federal + state tax breakdown for any US state.
No parameter schema in public metadata yet.
check_thresholdWhether wages trigger household employer obligations.
Whether wages trigger household employer obligations.
No parameter schema in public metadata yet.
preview_payrollDry-run a payroll calculation (no DB writes).
Dry-run a payroll calculation (no DB writes).
No parameter schema in public metadata yet.
run_payrollRun payroll end-to-end with YTD tracking and DB persistence (Starter+ required). As of v1.5.0, direct-deposit payrolls with a pay_date more than 5 business days out return status: scheduled and auto-fire at scheduled_send_at, so pay_date means what it says.
Run payroll end-to-end with YTD tracking and DB persistence (Starter+ required). As of v1.5.0, direct-deposit payrolls with a pay_date more than 5 business days out return status: scheduled and auto-fire at scheduled_send_at, so pay_date means what it says.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
NANNYKEEPER_API_KEY*secretNannyKeeper API key. Get a free key at https://www.nannykeeper.com/developers/keys
Readme
NannyKeeper — Household Employer Tax API
The only API for calculating US household employer (nanny) taxes. Covers all 50 states + DC.
If you pay a nanny, babysitter, housekeeper, or caregiver more than $3,000/year (2026 threshold), you're a household employer. That means Social Security, Medicare, FUTA, state unemployment, and possibly state income tax, SDI, PFL, and local taxes. The rules are different in every state. This API handles all of it.
What's in this repo
- mcp-server/ — MCP server so AI agents (Claude, ChatGPT, etc.) can calculate nanny taxes in conversation. Published on npm as @nannykeeper/mcp-server.
- examples/ — Working code examples in Python, JavaScript, and curl.
- CLAUDE.md / AGENTS.md — Instructions for AI coding assistants.
How to calculate nanny taxes with an API
Get a free API key (email only, no credit card) at nannykeeper.com/developers/keys, then:
Details
- Repository
- github.com/nannykeeper/mcp-server
- Website
- www.nannykeeper.com/developers/mcp
- Package
@nannykeeper/mcp-server- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active