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.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mcp_organizze-0.1.2.tar.gz.
File metadata
- Download URL: mcp_organizze-0.1.2.tar.gz
- Upload date:
- Size: 10.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f5e487b9af45a565b07594d322736e0b1214518bc897263dd126d5c075587b2a
|
|
| MD5 |
c237445d249cf31144b6c91819576795
|
|
| BLAKE2b-256 |
243c15c913303f91bf63e5ddb5cd990756fab5767bd29488ad10f57052c48338
|
Provenance
The following attestation bundles were made for mcp_organizze-0.1.2.tar.gz:
Publisher:
publish.yml on SamuelMoraesF/mcp-organizze
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mcp_organizze-0.1.2.tar.gz -
Subject digest:
f5e487b9af45a565b07594d322736e0b1214518bc897263dd126d5c075587b2a - Sigstore transparency entry: 962188790
- Sigstore integration time:
-
Permalink:
SamuelMoraesF/mcp-organizze@49fc794c266966e1dfdf71930ff1f32c2eee160d -
Branch / Tag:
refs/tags/v0.1.2 - Owner: https://github.com/SamuelMoraesF
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@49fc794c266966e1dfdf71930ff1f32c2eee160d -
Trigger Event:
push
-
Statement type:
File details
Details for the file mcp_organizze-0.1.2-py3-none-any.whl.
File metadata
- Download URL: mcp_organizze-0.1.2-py3-none-any.whl
- Upload date:
- Size: 10.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a5df7ea509ef9a6e00336d293852ef1766b58748c078daa703fff58faceff32a
|
|
| MD5 |
10f47f79877aef34b020257965b7ae76
|
|
| BLAKE2b-256 |
00689415c2d33d13beb3d767f0a6e214057496f0b64d8577ba654c028e983c37
|
Provenance
The following attestation bundles were made for mcp_organizze-0.1.2-py3-none-any.whl:
Publisher:
publish.yml on SamuelMoraesF/mcp-organizze
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mcp_organizze-0.1.2-py3-none-any.whl -
Subject digest:
a5df7ea509ef9a6e00336d293852ef1766b58748c078daa703fff58faceff32a - Sigstore transparency entry: 962188791
- Sigstore integration time:
-
Permalink:
SamuelMoraesF/mcp-organizze@49fc794c266966e1dfdf71930ff1f32c2eee160d -
Branch / Tag:
refs/tags/v0.1.2 - Owner: https://github.com/SamuelMoraesF
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@49fc794c266966e1dfdf71930ff1f32c2eee160d -
Trigger Event:
push
-
Statement type:
