Skip to main content
Glama
condosplit

condosplit

by sntfrancesco

condosplit

Plugin MCP per Claude Code — suddivisione automatica delle spese condominiali.

condosplit è un MCP server che estende Claude Code con strumenti dedicati alla gestione e ripartizione delle spese condominiali. Una volta installato, basta chiedere a Claude in linguaggio naturale e lui calcola le quote, mostra lo schema dell'edificio e mantiene lo storico.


Installazione

1. Clona e installa le dipendenze

git clone https://github.com/sntfrancesco/condosplit.git condosplit
cd condosplit
npm install

2. Registra il server in Claude Code (globale)

Il server va installato una volta sola a livello globale: legge condo.config.json dalla directory corrente, quindi funziona in qualsiasi progetto senza ulteriori configurazioni.

claude mcp add -s user condosplit node /percorso/assoluto/condosplit/src/server.js

Oppure modifica manualmente ~/.claude/settings.json:

{
  "mcpServers": {
    "condosplit": {
      "command": "node",
      "args": ["/percorso/assoluto/condosplit/src/server.js"]
    }
  }
}

3. Verifica che il server sia attivo

claude mcp list

Related MCP server: SplitwiseMCP

Utilizzo

Dopo l'installazione, Claude dispone di questi strumenti che può chiamare autonomamente durante la conversazione.

Inizializzare un progetto

Inizializza un progetto condosplit nella directory corrente

Crea condo.config.json e una copia di README_GUIDE-condosplit.md nella directory di lavoro.

Visualizzare lo schema

Mostrami lo schema del condominio

Calcolare una suddivisione

Calcola la suddivisione della bolletta luce di gen-feb 2026 per €150,52
Dividi la pulizia scala di febbraio 2026 da €80,00
Ripartisci la quota ascensore del primo trimestre 2026 di €210,50 e salvala nello storico

Quando vengono calcolate spese e sono presenti coordinate di pagamento configurate, Claude mostrerà la lista e chiederà quale includere nel report.

Gestire le coordinate di pagamento

Mostrami le coordinate di pagamento disponibili
Aggiungi una coordinata: Enel Energia, IBAN IT60X0542811101000000123456, banca Intesa Sanpaolo

Le coordinate vengono salvate in condo.coordinates.json nella directory del progetto. Ogni tipo di spesa in condo.config.json può avere un campo defaultPaymentCoordinatesId che suggerisce la coordinata predefinita.

Consultare lo storico

Mostrami lo storico delle spese condominiali

Strumenti MCP esposti

Strumento

Descrizione

condosplit_init

Crea condo.config.json e condo.coordinates.json nella directory specificata

condosplit_schema

Visualizza lo schema ASCII dell'edificio

condosplit_types

Elenca i tipi di spesa configurati

condosplit_split

Calcola la suddivisione di una spesa; se sono presenti coordinate, chiede quale includere nel report

condosplit_history

Mostra lo storico delle spese salvate

condosplit_coordinates

Elenca le coordinate di pagamento in condo.coordinates.json

condosplit_coordinates_save

Aggiunge o aggiorna una coordinata di pagamento


Struttura di condo.coordinates.json

File generato automaticamente nella directory di progetto. Contiene tutte le coordinate di pagamento configurate. Viene creato vuoto da condosplit_init e popolato con condosplit_coordinates_save.

{
  "coordinates": [
    {
      "id": "enel_energia",
      "label": "Enel Energia",
      "intestatario": "Condominio Via Roma 1",
      "iban": "IT60X0542811101000000123456",
      "swift": "BCITITMM",
      "banca": "Intesa Sanpaolo",
      "causale": "Bolletta luce scala",
      "note": "Inserire numero cliente in causale"
    }
  ]
}

Tutti i campi tranne id e label sono opzionali.


Struttura di condo.config.json

{
  "building": {
    "name": "Nome condominio",
    "floors": [
      {
        "level": 1,              // numero piano
        "label": "Primo Piano",  // etichetta leggibile
        "staircaseAccess": true, // false = nessun accesso scala (es. piano terra negozi)
        "units": [
          { "id": "I1.a", "label": "Proprietario A" },
          { "id": "I1.b", "label": "Proprietario B", "occupied": false }  // non abitato
        ]
      }
    ]
  },
  "expenseTypes": [
    {
      "id": "pulizia_scala",                        // usato nel tool condosplit_split
      "name": "Pulizia Scala",
      "splitRule": "occupied_staircase_equal",       // solo abitati con accesso scala
      "defaultPaymentCoordinatesId": "impresa_pulizie"  // ID in condo.coordinates.json (opzionale)
    },
    {
      "id": "bolletta_luce",
      "name": "Bolletta Luce Scala",
      "splitRule": "utility_breakdown",
      "utilityComponents": [
        { "name": "Autoclave",  "percentage": 33, "splitGroup": "all" },
        { "name": "Ascensore",  "percentage": 34, "splitGroup": "occupied_staircase" },
        { "name": "Luce Scala", "percentage": 33, "splitGroup": "occupied_staircase" }
      ]
    }
  ]
}

Campo occupied per unità

Ogni unità accetta il campo opzionale "occupied": false per indicare che l'interno è non abitato. Il default è true (abitato): omettere il campo equivale a "occupied": true.

Nello schema dell'edificio le unità non abitate sono marcate con ⊘.

Regole di ripartizione (splitRule)

Valore

Comportamento

equal_all

Quota uguale tra tutte le unità

staircase_equal

Quota uguale tra unità con staircaseAccess: true

occupied_equal

Quota uguale tra unità abitate

occupied_staircase_equal

Quota uguale tra unità abitate con staircaseAccess: true

utility_breakdown

Ripartizione per componenti, ognuno con percentuale e gruppo

Gruppi (splitGroup) — per utility_breakdown

Valore

Unità incluse

all

Tutte le unità

staircase

Unità con staircaseAccess: true

occupied_all

Unità abitate

occupied_staircase

Unità abitate con staircaseAccess: true


Struttura del progetto

condosplit/
├── src/
│   ├── server.js        ← entry point MCP server
│   ├── config.js        ← caricamento e validazione configurazione
│   ├── building.js      ← rendering schema ASCII
│   ├── expenses.js      ← logica di ripartizione
│   ├── report.js        ← formattazione report
│   ├── history.js       ← storico spese
│   ├── coordinates.js   ← gestione coordinate di pagamento
│   └── init.js          ← inizializzazione progetto
├── examples/
│   ├── condo.config.json
│   └── condo.coordinates.json
├── package.json
├── README.md
└── README_GUIDE-condosplit.md

Requisiti

  • Node.js >= 18

  • Claude Code con supporto MCP


Licenza

MIT

Available Tools

7 tools
condosplit_coordinatesA

Elenca tutte le coordinate di pagamento salvate in condo.coordinates.json (IBAN, banca, intestatario, ecc.).

Inputs: config_path.

condosplit_coordinates_saveB

Aggiunge o aggiorna una coordinata di pagamento in condo.coordinates.json. Se l'ID esiste già, sovrascrive il record.

Inputs: id (required), label (required), iban, note, +5 more.

condosplit_historyB

Mostra lo storico delle spese salvate con il flag save=true.

Inputs: config_path.

condosplit_initA

Inizializza un progetto condominiale: crea condo.config.json con la struttura di default (4 piani + piano terra, 2 interni per piano, 3 tipi di spesa predefiniti) nella directory specificata.

Inputs: project_dir.

condosplit_schemaB

Visualizza lo schema grafico ASCII dell'edificio condominiale con piani, interni ed etichette. Mostra quali unità hanno accesso alla scala.

Inputs: config_path.

condosplit_splitA

Calcola la suddivisione di una spesa condominiale tra gli interni e restituisce il riepilogo dettagliato con la quota di ciascun interno. Se payment_coordinates_id non è specificato e sono presenti coordinate salvate, restituisce anche la lista delle coordinate disponibili così che l'utente possa scegliere quale includere nel report.

Inputs: label (required), amount (required), expense_type_id (required), save, +2 more.

condosplit_typesA

Elenca tutti i tipi di spesa configurati in condo.config.json con le relative regole e criteri di ripartizione.

Inputs: config_path.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 7 tools

    Disambiguation5/5

    Ogni tool ha uno scopo chiaramente distinto: inizializzare, visualizzare lo schema, elencare i tipi di spesa, calcolare la ripartizione, gestire le coordinate e leggere lo storico. Anche i due tool sulle coordinate si distinguono bene perché uno salva/aggiorna e l'altro elenca.

    Naming Consistency3/5

    Tutti i tool condividono il prefisso condosplit_ e usano snake_case, ma la struttura interna è mista: alcuni nomi sono solo sostantivi (schema, types, history), altri sono verbi (init, split), e uno usa ordine sostantivo-verbo (coordinates_save). La convenzione è leggibile ma non uniforme.

    Tool Count5/5

    Sette tool sono una dimensione adeguata per il dominio di gestione delle spese condominiali: coprono inizializzazione, visualizzazione, calcolo e storico senza risultare superflui o sovrabbondanti.

    Completeness3/5

    Il flusso principale è coperto: init, split, storico e gestione coordinate sono presenti. Mancano però operazioni importanti come creare/modificare i tipi di spesa, eliminare coordinate o modificare la struttura dell'edificio dopo l'inizializzazione, rendendo il set non completamente autonomo.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      A standalone MCP server that provides complete access to the Splitwise API, enabling natural language management of expenses, groups, friends, and notifications in MCP-compatible clients like Claude Desktop and VS Code Copilot.
      9
      1
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      A local MCP server that enables AI clients like Codex, Claude Code, and Claude Desktop to manage Splitwise expenses, friends, groups, and more through natural language.
      2
      -
    • A
      license
      A
      quality
      D
      maintenance
      MCP server that connects Claude Code to the Holded API for natural language financial, accounting, and invoicing queries, with built-in Spanish PGC context.
      13
      2
      Apache 2.0
    • A
      license
      Not graded
      quality
      D
      maintenance
      Database schema management MCP server for Claude Code, enabling natural language management from business requirements to complete databases.
      MIT