English Français العربية

io.github.SamuelMoraesF/mcp-organizze

Official registry Finance and payments

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package mcp-organizze
Claude Code 
claude mcp add mcp-organizze -e 'ORGANIZZE_EMAIL=<ORGANIZZE_EMAIL>' -e 'ORGANIZZE_API_KEY=<your organizze_api_key>' -- uvx mcp-organizze==0.1.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mcp-organizze": {
            "command": "uvx",
            "args": [
                "mcp-organizze==0.1.2"
            ],
            "env": {
                "ORGANIZZE_EMAIL": "<ORGANIZZE_EMAIL>",
                "ORGANIZZE_API_KEY": "<your organizze_api_key>"
            }
        }
    }
}

Environment variables

  • ORGANIZZE_EMAIL required Email de login da sua conta Organizze
  • ORGANIZZE_API_KEY required secret Sua chave de API do Organizze
OCI package samuelmoraesf/mcp-organizze
Claude Code 
claude mcp add mcp-organizze -e 'ORGANIZZE_EMAIL=<ORGANIZZE_EMAIL>' -e 'ORGANIZZE_API_KEY=<your organizze_api_key>' -e 'MCP_PORT=8000' -e 'MCP_HOST=0.0.0.0' -- docker run -i --rm samuelmoraesf/mcp-organizze
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mcp-organizze": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "samuelmoraesf/mcp-organizze"
            ],
            "env": {
                "ORGANIZZE_EMAIL": "<ORGANIZZE_EMAIL>",
                "ORGANIZZE_API_KEY": "<your organizze_api_key>",
                "MCP_PORT": "8000",
                "MCP_HOST": "0.0.0.0"
            }
        }
    }
}

Environment variables

  • ORGANIZZE_EMAIL required Email de login da sua conta Organizze
  • ORGANIZZE_API_KEY required secret Sua chave de API do Organizze
  • MCP_PORT Porta do servidor HTTP
  • MCP_HOST Host do servidor HTTP

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. MCP Organizze
  2. ✨ Funcionalidades
  3. 🚀 Como Usar
  4. 🛠 Desenvolvimento e Publicação

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:

# Executa em modo STDIO (padrão para Claude Desktop)
ORGANIZZE_EMAIL=seu@email.com ORGANIZZE_API_KEY=sua_chave uvx mcp-organizze

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

{
  "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):

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

Executar com STDIO (Interativo):

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:

uv pip install .
# ou
pip install .

Rode o servidor:

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.

Frequently asked questions

What is io.github.SamuelMoraesF/mcp-organizze?

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

How do I install io.github.SamuelMoraesF/mcp-organizze?

It runs on your machine. In Claude Code: claude mcp add mcp-organizze -e 'ORGANIZZE_EMAIL=<ORGANIZZE_EMAIL>' -e 'ORGANIZZE_API_KEY=<your organizze_api_key>' -- uvx mcp-organizze==0.1.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.SamuelMoraesF/mcp-organizze need an API key?

Yes. It expects ORGANIZZE_EMAIL, ORGANIZZE_API_KEY, which you set in its configuration.

Is io.github.SamuelMoraesF/mcp-organizze open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.SamuelMoraesF/mcp-organizze?

It is published by SamuelMoraesF. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.