finplan

FinPlan — Claude Code Plugin

Personal finance projection engine powered by 60+ MCP tools. Monte Carlo projections, tax calculations, retirement planning, Social Security analysis, and interactive dashboards.

Install

From the marketplace:

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

To install for a specific project directory instead of globally:

claude plugin marketplace add bestdan/finplan-plugin
claude plugin install finplan@finplan-plugin --scope project

This writes the plugin config into .claude/plugins/ in the current directory, so it only activates when you run Claude Code from that project. Useful if you don't want FinPlan loaded in every session.

Or from a local clone:

git clone https://github.com/bestdan/finplan-plugin.git
claude plugin install finplan --plugin-dir ./finplan-plugin

Both approaches install the skill, commands, MCP server connection, and a hook that prompts you to allowlist curl for file downloads.

After installing, go to /plugins → Installed → finplan and make sure MCP is enabled, then restart your session.

Authentication

The FinPlan server requires authentication. The first time you invoke a FinPlan tool in a session, Claude Code opens your browser to sign in (Google, GitHub, or email magic link) and captures the token automatically — no manual config. OAuth-issued tokens last 3 days and renew silently via the same flow on expiry.

Use /finplan:login only when you need a long-lived (90-day) API key — e.g. for Claude Agent SDK, scripts, Cowork, or a shared project where the token must be pinned into .mcp.json. If you go that route, add .mcp.json to .gitignore so the token isn't committed.

Recommended: Allowlist curl for the FinPlan file server to avoid repeated approval prompts:

claude settings add allowedTools 'Bash(curl*mcp.finplan.tools*)'

What you get

Skill

Claude automatically discovers and uses FinPlan tools when you ask about financial planning. 14 tool categories covering projections, tax, accounts, goals, Social Security, mortgage, employer match, charts, and more.

Commands

Command	Description
/finplan:setup	Guided interview to set up your financial plan
/finplan:login	Set up API key authentication
/finplan:diagnose	Diagnose MCP connection issues
/finplan:read-state	Read financial state from local JSON file
/finplan:save-state	Save current state to local JSON file
/finplan:projection-dashboard	Generate interactive HTML projection dashboard
/finplan:profile	View and update your financial profile
/finplan:accounts	View and manage financial accounts
/finplan:goals	View and manage financial goals
/finplan:checkup	Review plan for life changes and updates

MCP Server

Auto-connects to the FinPlan MCP server at https://mcp.finplan.tools/mcp — no manual configuration needed.

Hook

On first FinPlan tool use, prompts you to allowlist curl for the file server if you haven't already. This avoids repeated approval dialogs when tools download result files.

Example prompts

• "What would my 401(k) look like in 30 years if I contribute $500/month?"
• "Calculate my federal income tax on $150,000 as married filing jointly"
• "When should I claim Social Security if my salary is $95,000?"
• "Compare a conservative vs aggressive portfolio over 20 years"
• "Create a retirement projection with a fan chart showing percentile outcomes"

Staying up to date

Enable auto-update (recommended)

The FinPlan plugin can update itself automatically when new versions are published. Enable auto-update for the marketplace:

/plugin → Marketplaces tab → finplan-plugin → Enable auto-update

When an update is available, Claude Code refreshes the plugin at startup and prompts you to run /reload-plugins.

Manual update

claude plugin update finplan

Version compatibility

On first FinPlan tool call each session, the plugin checks whether it meets the MCP server's minimum version requirement. If your plugin is outdated, you'll see a one-time hint to update.

Testing locally

After cloning this repo, test the plugin before making changes.

1. Load the plugin from the local directory

claude --plugin-dir .

This starts Claude Code with the plugin loaded from your working copy instead of an installed version.

2. Verify the plugin loaded

In the Claude Code session, run /help and confirm: