# NannyKeeper Household Payroll & Taxes

Computes US household employment taxes and handles payroll across all 50 states and DC directly inside your AI agent chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: NannyKeeper
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/NannyKeeper/mcp-server
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/nannykeeper-household-payroll-taxes

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `NANNYKEEPER_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp-server -e NANNYKEEPER_API_KEY=<NANNYKEEPER_API_KEY> -- npx -y @nannykeeper/mcp-server
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add nannykeeper-household-payroll-taxes --env NANNYKEEPER_API_KEY=<NANNYKEEPER_API_KEY> -- npx -y @nannykeeper/mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "nannykeeper-household-payroll-taxes": {
            "command": "npx",
            "args": [
                "-y",
                "@nannykeeper/mcp-server"
            ],
            "env": {
                "NANNYKEEPER_API_KEY": "<NANNYKEEPER_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e NANNYKEEPER_API_KEY=<NANNYKEEPER_API_KEY> nannykeeper-household-payroll-taxes npx -y @nannykeeper/mcp-server
```
Replace <…> with your own values

## When to use it
- 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
- 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_payroll` for biweekly pay in Texas without persisting data

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44591
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5469
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2817
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2197
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md