# Financier

Financier connects a personal spending plan built from real bank transactions to your agent. Runs as an MCP server in Claude Code, Cursor, Copilot and other editors via OAuth or API key.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: financier-sh
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/financier-sh/financier
- Updated: 2026-09-22
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/financier

## What it does

An MCP server for managing personal finances through an agent. It links to a bank account, syncs transactions, categorises spending, and builds a forecast. The agent can view budget stages, monthly figures, spending by category or merchant, and set up webhooks for automation.

The server runs at `https://financier.sh/mcp` with HTTP transport, authenticated via OAuth 2.1 or `x-api-key`. Accounts are invite-only, but a demo bank provides a synthetic household to explore. An agent can start without user credentials as an anonymous sandbox identity; later, the person claims it with a verification code at financier.sh/claim.

Beyond MCP, there's a TypeScript SDK (`@financier-sh/sdk`), CLI (`financier`), and REST API. Webhooks use Web Bot Auth signatures, verifiable against the service's public key directory without a shared secret. SDK types are generated from the OpenAPI spec.

## Requirements
- Remote server: `https://financier.sh/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http financier https://financier.sh/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add financier --url https://financier.sh/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "financier": {
            "url": "https://financier.sh/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "financier": {
            "type": "http",
            "url": "https://financier.sh/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http financier https://financier.sh/mcp
```

## When to use it
- check current balance and forecast spending for the month
- find largest expenses by category or merchant
- sync bank transactions into a multi-month budget plan
- trigger webhooks when budget milestones occur

## Example prompts
- Show me my current balance and how much budget is left
- Which spending category had the biggest impact last month
- Connect my bank account and build a three-month financial forecast

## Similar
- [Rozbij Bank](https://affpapa.org/en/nevibecode/mcp/rozbij-bank.md) — MCP server · 1137 installs
- [SecureLend Market](https://affpapa.org/en/nevibecode/mcp/securelend-market.md) — MCP server · 485 installs
- [Porto Bank MCP](https://affpapa.org/en/nevibecode/mcp/porto-bank-mcp.md) — MCP server · 439 installs
- [Ágora MCP](https://affpapa.org/en/nevibecode/mcp/agora-mcp.md) — MCP server · 426 installs
- [debt-payoff](https://affpapa.org/en/nevibecode/skills/debt-payoff.md) — skill · 495 installs
- [NYC Budget](https://affpapa.org/en/nevibecode/mcp/nyc-budget.md) — MCP server · ★ 20 repo stars

---
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
