English Français العربية

io.github.SamuelMoraesF/mcp-organizze

Registre officiel Finance et paiements

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

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
Configuration JSON (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>"
            }
        }
    }
}

Variables d'environnement

  • ORGANIZZE_EMAIL obligatoire Email de login da sua conta Organizze
  • ORGANIZZE_API_KEY obligatoire 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
Configuration JSON (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"
            }
        }
    }
}

Variables d'environnement

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

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

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

Questions fréquentes

Qu'est-ce que io.github.SamuelMoraesF/mcp-organizze ?

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

Comment installer io.github.SamuelMoraesF/mcp-organizze ?

Il s'exécute sur votre machine. Dans 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. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.SamuelMoraesF/mcp-organizze ?

Oui. Il attend ORGANIZZE_EMAIL, ORGANIZZE_API_KEY, à renseigner dans sa configuration.

io.github.SamuelMoraesF/mcp-organizze est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.SamuelMoraesF/mcp-organizze ?

Il est publié par SamuelMoraesF. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.