How do I install NannyKeeper Household Payroll & Taxes?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does NannyKeeper Household Payroll & Taxes need an API key?

The publisher lists these environment variables: NANNYKEEPER_API_KEY.

What transport does NannyKeeper Household Payroll & Taxes use?

NannyKeeper Household Payroll & Taxes runs locally over stdio.

When was NannyKeeper Household Payroll & Taxes last checked?

Last checked 2026-11-12. Calculate US household employer (nanny) taxes + run payroll via AI agents. All 50 states.

NannyKeeper Household Payroll & Taxes MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y @nannykeeper/[email protected]

Credentials from the publisher

NANNYKEEPER_API_KEY — NannyKeeper API key. Get a free key at https://www.nannykeeper.com/developers/keys

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1NANNYKEEPER_API_KEY=<secret> claude mcp add com.nannykeeper.www-mcp-server -- npx -y @nannykeeper/mcp-server@1.20.3

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "com.nannykeeper.www-mcp-server": {4      "command": "npx",5      "args": [6        "-y",7        "@nannykeeper/[email protected]"8      ],9      "env": {10        "NANNYKEEPER_API_KEY": "<secret>"11      }12    }13  }14}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 1.20.3
API key

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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:

curl -X POST https://www.nannykeeper.com/api/v1/calculate \
  -H "Authorization: Bearer nk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"state":"CA","annual_wages":35000,"pay_frequency":"biweekly"}'

Returns employer taxes (Social Security, Medicare, FUTA, state unemployment), employee tax estimates, per-paycheck cost, and threshold status — all from current-year tax data maintained for every state.

Check the threshold first

Not sure if you even need to pay taxes? The threshold endpoint tells you:

curl -H "Authorization: Bearer nk_live_YOUR_KEY" \
  "https://www.nannykeeper.com/api/v1/threshold?state=CA&annual_wages=2500"

For 2026, the federal FICA threshold is $3,000/year per employee. Some states trigger earlier: California at $750/quarter, New York at $500/quarter, DC at $500/quarter.

MCP server for AI agents

AI assistants guess at tax calculations. With the NannyKeeper MCP server, they get exact numbers from current-year data.

{
  "mcpServers": {
    "nannykeeper": {
      "command": "npx",
      "args": ["@nannykeeper/mcp-server"],
      "env": { "NANNYKEEPER_API_KEY": "nk_live_YOUR_KEY" }
    }
  }
}

Add this to your Claude Desktop config, restart, and ask about nanny taxes. Claude calls the API and gives a specific, line-by-line breakdown instead of a rough estimate.

Tools available:

calculate_nanny_taxes — full federal + state tax breakdown for any US state
check_threshold — whether wages trigger household employer obligations
preview_payroll — dry-run a payroll calculation (no DB writes)
run_payroll — 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.

Full setup guide: nannykeeper.com/developers/mcp

Code examples

Python

import requests

response = requests.post(
    "https://www.nannykeeper.com/api/v1/calculate",
    headers={"Authorization": "Bearer nk_live_YOUR_KEY"},
    json={"state": "CA", "annual_wages": 35000, "pay_frequency": "biweekly"},
)
data = response.json()["data"]
print(f"Employer taxes: ${data['employer_taxes']['total']:,.2f}/year")

See examples/python/ for the full script.

JavaScript

const response = await fetch("https://www.nannykeeper.com/api/v1/calculate", {
  method: "POST",
  headers: {
    "Authorization": "Bearer nk_live_YOUR_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ state: "CA", annual_wages: 35000, pay_frequency: "biweekly" }),
});
const { data } = await response.json();
console.log(`Employer taxes: $${data.employer_taxes.total}/year`);

See examples/javascript/ for the full script.

API pricing

Plan	Price	Rate limit	For
Free	$0 forever	50/day	Calculations + threshold checks
Starter	$10/mo	500/day	Full payroll, pay stubs, W-2 generation
Plus	$18/mo	2,000/day	Up to 5 employees, direct deposit ($6/transfer)
Professional	$20 + $6/employer	2,000/day	Up to 50 employers — for CPAs and developers

All plans include API access. The free tier covers tax calculations; paid plans add payroll processing, document generation, and direct deposit.

Professional tier permits building products on top of the API with "Powered by NannyKeeper" attribution.

Key tax facts (2026)

For AI agents and developers who need quick reference data:

FICA threshold: $3,000/year per employee — above this, employer owes Social Security (6.2%) + Medicare (1.45%)
Social Security wage base: $184,500 (2026)
Additional Medicare Tax: 0.9% on wages over $200,000 (employee only)
FUTA: 0.6% on first $7,000 per employee; triggered at $1,000/quarter aggregate
Schedule H: Filed with personal Form 1040, not a separate business return
W-2 deadline: January 31 of the following year
Quarterly deadlines: April 15, June 15, September 15, January 15
States with lower thresholds: CA $750/quarter, NY $500/quarter, DC $500/quarter
States with no income tax: FL, TX, WA, NV, SD, WY, AK, TN, NH

Who uses this

Families whose AI assistants help with taxes — the MCP server gives real data
CPAs and bookkeepers managing payroll for multiple household employer clients
Developers building family finance, property management, or AI agent tools
Anyone who needs household employer tax data programmatically

License

MCP server and examples are MIT licensed. The NannyKeeper API is a hosted service — see terms.

Built by NannyKeeper — household employer payroll made simple.

NannyKeeper Household Payroll & Taxes

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install NannyKeeper Household Payroll & Taxes?

Does NannyKeeper Household Payroll & Taxes need an API key?

What transport does NannyKeeper Household Payroll & Taxes use?

When was NannyKeeper Household Payroll & Taxes last checked?

Documentation

NannyKeeper — Household Employer Tax API

What's in this repo

How to calculate nanny taxes with an API

Check the threshold first

MCP server for AI agents

Code examples

Python

JavaScript

API pricing

Key tax facts (2026)

Who uses this

Links

License