Summary
Connects Claude to Organizze, a Brazilian personal finance manager, through their v2 API. You get tools to create transactions (expenses and revenue), list bank accounts, check balances, manage credit card invoices, and work with budgets and categories. Ships with both stdio transport for local Claude Desktop use and streamable HTTP for remote deployments. The Docker image defaults to SSE on port 8000, while uvx runs stdio out of the box. Requires your Organizze email and API key as environment variables. Useful if you're already tracking finances in Organizze and want Claude to log transactions or pull spending reports without leaving the conversation.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
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.
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →Configuration
ORGANIZZE_EMAIL*Email de login da sua conta Organizze
ORGANIZZE_API_KEY*secretSua chave de API do Organizze
MCP_PORTdefault: 8000Porta do servidor HTTP
MCP_HOSTdefault: 0.0.0.0Host do servidor HTTP