Mcp Organizze

io.github.SamuelMoraesFPublished by GitHub account SamuelMoraesFv0.1.2Updated Oct 24, 2026

MCP para integração com o gestor financeiro Organizze. Crie transações, consulte saldos e metas.

VerifiedSTDIODesktop onlyProductivity & WorkflowFinance

Overview

AI-generated overview

Lets an assistant work with the Organizze personal finance manager: create transactions, check balances, accounts, credit card invoices and goals.

What you can do
Wraps the Organizze v2 API as MCP tools. It can list, create and detail bank accounts, create expenses and income and list transactions, list and detail credit card invoices, and manage categories and goals. It works with any MCP client, such as Claude Desktop.
When to use it
Use it when you want an assistant to record or review personal finances held in Organizze, for example logging an expense, checking an account balance, or reviewing a credit card invoice and budget goals.
Requirements
A local runtime: uv/uvx or Python with pip for the PyPI package mcp-organizze, or Docker for the OCI image. Needs an Organizze account plus ORGANIZZE_EMAIL and the ORGANIZZE_API_KEY secret. MCP_HOST and MCP_PORT configure the HTTP mode.
Before you install
Requires the ORGANIZZE_API_KEY secret and ORGANIZZE_EMAIL for a real Organizze account, so the assistant acts on live financial data. Creating transactions and accounts writes to that account, and the Docker image can expose an HTTP endpoint on port 8000, so bind it carefully.

Installation

In SourceWeft

  1. Open Mcp Organizze in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

MCP Organizze

Servidor MCP para integração com o gestor financeiro Organizze, compatível com qualquer cliente MCP (Claude Desktop, etc).

Este projeto expõe a API v2 do Organizze como ferramentas de IA, permitindo criar transações, consultar saldos, metas e muito mais.

✨ Funcionalidades

  • Contas: Listar, criar e detalhar contas bancárias.
  • Transações: Criar (despesas/receitas) e listar movimentações.
  • Cartões de Crédito: Listar e detalhar faturas.
  • Categorias e Metas: Gerenciamento completo.

🚀 Como Usar

Pré-requisitos

Você precisará das suas credenciais do Organizze:

  • ORGANIZZE_EMAIL: Seu email de login.
  • ORGANIZZE_API_KEY: Sua chave de API.

Opção 1: Via UVX (Recomendado)

Se você tem o uv instalado, pode rodar diretamente sem instalar nada:

bash
# Executa em modo STDIO (padrão para Claude Desktop)[email protected] ORGANIZZE_API_KEY=sua_chave uvx mcp-organizze

Para integrar ao Claude Desktop, adicione ao seu arquivo de configuração:

json
{  "mcpServers": {    "organizze": {      "command": "uvx",      "args": ["mcp-organizze"],      "env": {        "ORGANIZZE_EMAIL": "seu_email",        "ORGANIZZE_API_KEY": "sua_chave_api"      }    }  }}

Opção 2: Via Docker

A imagem Docker roda por padrão em modo Streamable HTTP (SSE) na porta 8000, ideal para uso remoto ou em servidores.

Executar com SSE (Porta 8000):

bash
docker run -p 8000:8000 \  -e ORGANIZZE_EMAIL=seu_email \  -e ORGANIZZE_API_KEY=sua_chave \  mcp-organizze

Executar com STDIO (Interativo):

bash
docker run -i \  -e ORGANIZZE_EMAIL=seu_email \  -e ORGANIZZE_API_KEY=sua_chave \  mcp-organizze --transport stdio

Opção 3: Instalação Local (Pip/UV)

Clone o repositório e instale:

bash
uv pip install .# oupip install .

Rode o servidor:

bash
python -m mcp_organizze

🛠 Desenvolvimento e Publicação

Estrutura do Projeto

  • src/mcp_organizze: Código fonte do pacote.
  • pyproject.toml: Configuração de build e dependências.
  • Dockerfile: Configuração para containerização.
  • .github/workflows: Actions para CI/CD.

Source: README.md at commit 9b69c53

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts