mcpField
O
Organizze

Organizze

Local
github.com/silviorodriguesFinance2Updated 31w ago

About Organizze

Organizze MCP connects Claude to the Organizze personal finance API, letting users query and manage financial information through natural-language requests. Its tools cover accounts, transactions, transfers, cards, budgets, and spending summaries.

Key features

  1. 01List bank accounts
  2. 02Browse and create transactions
  3. 03Review account transfers
  4. 04Inspect cards and invoices
  5. 05View budgets and categories
  6. 06Summarize spending by category

Use cases

  1. 01Check spending over a date range
  2. 02Compare purchases with a category budget
  3. 03Review credit-card invoices
  4. 04Record an expense or income

MCP support

The MCP server connects Claude to the Organizze personal finance API and exposes tools for retrieving and creating financial records.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
"mcpServers": {
"organizze": {
"command": "npx",
"args": [
"-y",
"organizze-mcp"
]
}
}
}
Run commandnpx -y organizze-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmorganizze-mcp

Tools

12

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
account_idnumberNoOrganizze account ID. Omit to list all accounts.

Details

From the project README

Organizze MCP

An MCP (Model Context Protocol) server that connects Claude to the Organizze personal finance API. Ask Claude natural-language questions about your finances and it will fetch the right data automatically.

Installation

Add the server to your Claude MCP configuration:

{
  "mcpServers": {
    "organizze-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "organizze-mcp",
        "--organizze-username=YOUR_USERNAME",
        "--organizze-api-key=YOUR_API_KEY"
      ]
    }
  }
}

Available Tools

Accounts
ToolDescription
get-bank-accountsList all bank accounts or fetch one by ID
Transactions
ToolDescription
get-transactionsList transactions for a date range, optionally filtered by account or recurring status. Defaults to the current month
get-transactionGet full details of a single transaction by ID
create-transactionCreate a one-time expense or income transaction
Transfers
ToolDescription
get-transfersList transfers between bank accounts for a date range. Defaults to the current month
get-transferGet full details of a single transfer by ID
Credit Cards
ToolDescription
get-credit-cardsList all credit cards or fetch one by ID
get-credit-cards-invoicesList invoices for a credit card. Defaults to the current year
get-credit-cards-invoice-detailsGet full invoice details including line-item transactions and payment status
Budgets and Categories
ToolDescription
get-budgetsGet monthly or annual budget targets by category
get-categoriesList all categories or fetch one by ID
get-spending-summaryGet spending grouped by category with totals, percentages, and optional budget comparison

Example Prompts

What did I spend last month?
Show me all transactions from my Nubank account in March.
How close am I to my grocery budget this month?
List my credit card invoices for 2025.
I spent R$45 on lunch today — add it to my Food category.
How much did I transfer between accounts this year?

Development

npm install
npm run build   # compile TypeScript
npm test        # run the test suite
npm run test:watch  # watch mode

A CI workflow runs the build and tests automatically on every pull request.

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.