Kanithan MCP Server

The official Model Context Protocol (MCP) server for the Kanithan Expense, Habit & Trip Tracker.

This server allows AI agents (like Claude Desktop, Cline, and Cursor) to securely interact with your personal Kanithan database to log expenses and habits directly via conversational prompts.

Setup Instructions

1. Generate an API Token

First, log into your Kanithan account and navigate to Settings > API Access. Generate a new Personal Access Token (PAT) with the necessary scopes (e.g., expenses:write, habits:read).

Copy this token—it will start with knth_.

2. Configure Your AI Agent

You do not need to clone this repository. Simply add the following configuration to your MCP client (like Claude Desktop's claude_desktop_config.json or Cline's cline_mcp_settings.json):

{
  "mcpServers": {
    "kanithan": {
      "command": "npx",
      "args": ["-y", "kanithan-mcp"],
      "env": {
        "KANITHAN_API_TOKEN": "knth_YOUR_GENERATED_TOKEN_HERE"
      }
    }
  }
}

By default, the server connects to the production Kanithan API. If you are a developer testing locally or on the dev environment, you can override the API URL by adding the KANITHAN_API_URL environment variable:

      "env": {
        "KANITHAN_API_TOKEN": "knth_YOUR_GENERATED_TOKEN_HERE",
        "KANITHAN_API_URL": "https://family-expense-tracker-fe21f.web.app/api/v1"
      }

Supported Tools

Habit Tools

• list_habits — Discover your configured habits and their internal IDs.
• log_habit — Log a specific value or boolean status to a habit on a given date.
• get_habit_summary — NEW Get a monthly breakdown for a habit: completed days, total value, and per-day detail.

Expense Tools

• log_expense — Log a daily expense into your family dashboard.
• delete_expense — NEW Permanently delete an expense by ID (owner only).
• edit_expense — NEW Update amount, category, date, or note on an existing expense (owner only).

Trip Tools

• list_trips — List all trips you are a member of (use this to get tripId).
• create_trip — Create a new trip with a name, description, and dates.
• add_trip_expense — Add an expense to a specific trip, with payer and optional splits.
• get_trip_settlement — Get the full settlement report: who paid, net balances, and who owes whom.

API Documentation

Interactive Swagger UI is available after app deployment at:

https://app.kanithan.in/api/v1/swagger.html

The raw OpenAPI 3.0 spec is at /api/v1/openapi.json.