Claude Code Setup
Claude Code is the recommended way to use FinPlan. The plugin installs the skill, slash commands, MCP server connection, and a hook — all in one step.
Install the Plugin
Section titled “Install the Plugin”claude plugin marketplace add bestdan/finplan-pluginclaude plugin install finplan@finplan-pluginThis installs:
- Skill — Claude automatically discovers and uses FinPlan tools when you ask about financial planning
- Planning slash commands —
/finplan:setup,/finplan:read-state,/finplan:save-state,/finplan:projection-dashboard,/finplan:profile,/finplan:accounts,/finplan:goals,/finplan:checkup - Scenario slash commands —
/finplan:what-if(turn a natural-language what-if into a typed scenario, project it against your plan, and refresh a side-by-side comparison page),/finplan:compare-scenarios(render your base plan vs your saved scenarios as an offline, self-contained HTML comparison page, and list or remove scenarios),/finplan:scenario(drill into one saved scenario: an offline page of its overrides, projection detail, and goal outcomes, plus ad-hoc analyses nested under it) - Check-in & snapshot slash commands —
/finplan:checkin-init(scaffold asnapshots/check-in workspace),/finplan:checkin(run a recurring financial check-in: build, save, and diff a snapshot, then seed the note),/finplan:save-snapshot(save an immutable snapshot tosnapshots/<as_of>/snapshot.json),/finplan:read-snapshot(read a saved snapshot using targetedjqqueries) - Setup & troubleshooting slash commands —
/finplan:demo(load the Larson family sample profile so you can try every FinPlan feature with zero real data),/finplan:login(configure a long-lived manual API key; not needed for normal use — OAuth handles auth automatically),/finplan:diagnose(diagnose MCP connection issues) - MCP server connection — Auto-configured via
.mcp.json, no manual settings needed - Hook — On first FinPlan tool use, prompts you to allowlist
curlfor the file server
Recommended: let FinPlan’s tools, and curl against its file server, run without an approval prompt each time. Append these two entries to the permissions.allow array in ~/.claude/settings.json (create the array if it isn’t there). Don’t replace the array: keep the entries already in it.
"mcp__plugin_finplan_finplan","Bash(curl*mcp.finplan.tools*)"The first rule lets FinPlan’s tools run without a prompt each time; the second allows curl only against the FinPlan file server.
Sign In
Section titled “Sign In”FinPlan requires a free account. The first time you invoke a FinPlan tool in a new session, Claude Code opens your browser to sign in (Google, email and password, or email magic link). The token is stored by Claude Code and lasts 30 days — you don’t need to edit .mcp.json or copy any keys.
If you need a long-lived 90-day API key instead — e.g. for Claude Agent SDK scripts or Cowork — run /finplan:login to paste one into .mcp.json.
If something goes wrong, run /finplan:diagnose.
Verification
Section titled “Verification”Start Claude Code and confirm the plugin loaded:
claude- Run
/helpand check that the FinPlan skill and/finplan:*commands appear - Try a FinPlan command:
Calculate federal income tax for $85,000 filing single in 2026 - Try
/finplan:read-state— should report no file found or read existing state
Updating
Section titled “Updating”claude plugin update finplan