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 (optional)

FinPlan works without authentication. To enable authenticated access:

1. Create an account at https://mcp.finplan.prethink.io/auth/signup
2. Create an API key at https://mcp.finplan.prethink.io/auth/keys
3. Run /finplan:login and paste your key

The key is saved to .mcp.json in your project directory and used automatically on the next session. If your project is version-controlled, add .mcp.json to .gitignore to avoid committing the token.

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

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

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.prethink.io/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:

• The FinPlan skill appears in the skills list
• The namespaced commands appear: /finplan:read-state, /finplan:save-state, /finplan:projection-dashboard