mcp-organizze — Claude Code MCP server: what it does, how to install
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.
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-organizzeWhat mcp-organizze 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.
What it helps with
- 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 for the agent
- 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.
How to install mcp-organizze
Platform CLI
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-organizzeReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-organizze <command>
Platform CLI
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-organizzeReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-organizze <command>
Config file
{
"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>
Config file
{
"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>
Platform CLI
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-organizzeReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from mcp-organizze <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-organizze
How to install mcp-organizze in Claude Code?
Run claude mcp add mcp-organizze -e ORGANIZZE_EMAIL=<ORGANIZZE_EMAIL> -e ORGANIZZE_API_KEY=<ORGANIZZE_API_KEY> -- uvx mcp-organizze with your actual email and API key.
What does mcp-organizze do?
It exposes Organizze financial management endpoints to your agent. The assistant can track balances, log income or spending, and check credit card bills.
Can I run mcp-organizze using Docker?
Yes. The container runs with SSE on port 8000 by default, or you can switch it to standard IO by adding the --transport stdio flag.
