Back to Browse

Organizze MCP Server

Developer ToolsModerate6.8MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

6.8
Moderate6.8Moderate Risk

Valid MCP server (1 strong, 1 medium validity signals). 3 known CVEs in dependencies (1 critical, 1 high severity) Imported from the Official MCP Registry. Trust signals: trusted author (4/4 approved). 1 finding(s) downgraded by scanner intelligence.

6 files analyzed · 4 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Email de login da sua conta OrganizzeOptional

Environment variable: ORGANIZZE_EMAIL

Sua chave de API do OrganizzeRequired

Environment variable: ORGANIZZE_API_KEY

Porta do servidor HTTPOptional

Environment variable: MCP_PORT

Host do servidor HTTPOptional

Environment variable: MCP_HOST

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-samuelmoraesf-mcp-organizze": {
      "env": {
        "MCP_HOST": "your-mcp-host-here",
        "MCP_PORT": "your-mcp-port-here",
        "ORGANIZZE_EMAIL": "your-organizze-email-here",
        "ORGANIZZE_API_KEY": "your-organizze-api-key-here"
      },
      "args": [
        "mcp-organizze"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub 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)
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.

Reviews

No reviews yet

Be the first to review this server!