Skip to content

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.

Terminal window
claude plugin marketplace add bestdan/finplan-plugin
claude plugin install finplan@finplan-plugin

This 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 a snapshots/ 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 to snapshots/<as_of>/snapshot.json), /finplan:read-snapshot (read a saved snapshot using targeted jq queries)
  • 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 curl for 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.

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.

Start Claude Code and confirm the plugin loaded:

Terminal window
claude
  • Run /help and 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
Terminal window
claude plugin update finplan