How do I use condosplit?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@condosplit calcola suddivisione bolletta luce gen-feb 2026 €150,52" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

condosplit

by sntfrancesco

Overview Schema Related Servers Score Discussions

JavaScript

Local

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: Splitwise MCP Server

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

This server cannot be installed

license - not found

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/sntfrancesco/condosplit'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

condosplit

Installazione

1. Clona e installa le dipendenze

2. Registra il server in Claude Code (globale)

3. Verifica che il server sia attivo

Utilizzo

Inizializzare un progetto

Visualizzare lo schema

Calcolare una suddivisione

Gestire le coordinate di pagamento

Consultare lo storico

Strumenti MCP esposti

Struttura di condo.coordinates.json

Struttura di condo.config.json

Campo occupied per unità

Regole di ripartizione (splitRule)

Gruppi (splitGroup) — per utility_breakdown

Struttura del progetto

Requisiti

Licenza

Maintenance

Resources

Looking for Admin?

Latest Blog Posts

MCP directory API

Struttura di `condo.coordinates.json`

Struttura di `condo.config.json`

Campo `occupied` per unità

Regole di ripartizione (`splitRule`)

Gruppi (`splitGroup`) — per `utility_breakdown`