mcpField
O
Organizze

Organizze

Local
github.com/SamuelMoraesFFinance6Updated 36w ago
Repository

About Organizze

Organizze is an MCP server that exposes the Organizze finance manager's API v2 as tools for AI clients. It covers accounts, transactions, credit card statements, categories, and goals.

Key features

  1. 01List and manage bank accounts
  2. 02Create and list transactions
  3. 03View credit card statements
  4. 04Manage categories and goals
  5. 05STDIO and Streamable HTTP modes

Use cases

  1. 01Creating income and expense transactions
  2. 02Checking account balances and details
  3. 03Reviewing card statements
  4. 04Managing finance categories and goals

MCP support

Exposes Organizze API v2 operations as tools for MCP clients, including account, transaction, card, category, and goal management.

#organizze#finance

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "organizze": {
      "command": "uvx",
      "args": [
        "mcp-organizze"
      ],
      "env": {
        "ORGANIZZE_EMAIL": "<ORGANIZZE_EMAIL>",
        "ORGANIZZE_API_KEY": "<ORGANIZZE_API_KEY>",
        "MCP_PORT": "<MCP_PORT>",
        "MCP_HOST": "<MCP_HOST>"
      }
    }
  }
}
Run commanduvx mcp-organizze
Environment variables to set
ORGANIZZE_EMAILEmail de login da sua conta Organizze
ORGANIZZE_API_KEYSecretSua chave de API do Organizze
MCP_PORTPorta do servidor HTTP
MCP_HOSTHost do servidor HTTP

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypimcp-organizze0.1.2
ocisamuelmoraesf/mcp-organizze

Tools

33

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
idintegerYes

Details

From the project 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:

# 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:

{
  "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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.