# mcp-organizze

Connects the Organizze finance manager API to your AI client. It lets you inspect account balances, track card invoices, and log transactions directly in chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6
- Author: SamuelMoraesF
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/SamuelMoraesF/mcp-organizze
- Updated: 2026-02-18
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-organizze

## What it does

This server translates Organizze v2 API endpoints into tool calls for your coding assistant. It reads bank account summaries, registers incoming and outgoing transactions, inspects budget categories, and checks credit card statements.

You can launch the process via `uvx mcp-organizze` over standard input-output or deploy the Docker image, which uses SSE transport on port 8000 by default. Without valid `ORGANIZZE_EMAIL` and `ORGANIZZE_API_KEY` environment values, the server cannot reach the service.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `ORGANIZZE_EMAIL`, `ORGANIZZE_API_KEY`, `MCP_PORT`, `MCP_HOST` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env ORGANIZZE_EMAIL=<ORGANIZZE_EMAIL> --env ORGANIZZE_API_KEY=<ORGANIZZE_API_KEY> --env MCP_PORT=<MCP_PORT> --env MCP_HOST=<MCP_HOST> --transport stdio mcp-organizze -- uvx mcp-organizze
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-organizze <command>

### Codex

**Platform CLI**
```bash
codex mcp add mcp-organizze --env ORGANIZZE_EMAIL=<ORGANIZZE_EMAIL> --env ORGANIZZE_API_KEY=<ORGANIZZE_API_KEY> --env MCP_PORT=<MCP_PORT> --env MCP_HOST=<MCP_HOST> -- uvx mcp-organizze
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-organizze <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-organizze": {
            "command": "uvx",
            "args": [
                "mcp-organizze"
            ],
            "env": {
                "ORGANIZZE_EMAIL": "<ORGANIZZE_EMAIL>",
                "ORGANIZZE_API_KEY": "<ORGANIZZE_API_KEY>",
                "MCP_PORT": "<MCP_PORT>",
                "MCP_HOST": "<MCP_HOST>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-organizze <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-organizze": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "mcp-organizze"
            ],
            "env": {
                "ORGANIZZE_EMAIL": "<ORGANIZZE_EMAIL>",
                "ORGANIZZE_API_KEY": "<ORGANIZZE_API_KEY>",
                "MCP_PORT": "<MCP_PORT>",
                "MCP_HOST": "<MCP_HOST>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-organizze <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e ORGANIZZE_EMAIL=<ORGANIZZE_EMAIL> -e ORGANIZZE_API_KEY=<ORGANIZZE_API_KEY> -e MCP_PORT=<MCP_PORT> -e MCP_HOST=<MCP_HOST> mcp-organizze uvx mcp-organizze
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-organizze <command>

## When to use it
- record new expenses and income entries in Organizze
- inspect current bank account balances
- pull credit card invoice details
- review spending categories and financial goals

## Example prompts
- Check the current balance across my Organizze accounts.
- Add a new expense of 50 for groceries in Organizze.
- Show the latest credit card invoice details.

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89609
- [CCXT](https://affpapa.org/en/nevibecode/mcp/ccxt.md) — MCP server · ★ 44591
- [Finance Toolkit](https://affpapa.org/en/nevibecode/mcp/finance-toolkit.md) — MCP server · ★ 5469
- [EdgarTools](https://affpapa.org/en/nevibecode/mcp/edgartools.md) — MCP server · ★ 2817
- [LetsFG — Flights & Hotels](https://affpapa.org/en/nevibecode/mcp/letsfg-flights-hotels.md) — MCP server · ★ 2197
- [AutoTS](https://affpapa.org/en/nevibecode/mcp/autots.md) — MCP server · ★ 1434

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