Skip to content

Latest commit

 

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SupaLedger MCP Server

SupaLedger

Small business accounting, CRM, and invoicing — ask Claude about your business.

WebsitePrivacy PolicyTool ReferenceSecurity


What is SupaLedger?

SupaLedger is a unified small business operating system that combines accounting, CRM, and invoicing in one platform. Connect SupaLedger to Claude to ask questions about your business in plain English.

The MCP connector is read-only. Claude can view your financial reports, aging summaries, and contacts, but it cannot create, modify, or delete any data in your SupaLedger account.


Available Tools

# Tool Description
1 platform_get_org_context Get a summary of your business: name, active modules, key financial metrics, and recent activity. Call this first to establish context.
2 accounting_get_trial_balance View the trial balance to check if the books are balanced. Supports date ranges and summary/detail modes.
3 accounting_get_profit_and_loss Pull a profit and loss (income) statement for any date range. Shows revenue, expenses, and net income.
4 accounting_get_balance_sheet Generate a balance sheet showing assets, liabilities, equity, and retained earnings as of any date.
5 accounting_get_ar_aging Check accounts receivable aging — who owes you money and how overdue, bucketed by 30-day intervals.
6 accounting_get_ap_aging Check accounts payable aging — what you owe vendors and how overdue, bucketed by 30-day intervals.
7 crm_search_contacts Search business contacts by name, type (customer/vendor/employee), or list all contacts.

All tools default to summary mode, returning aggregated totals without personal details. Detail mode is available on request.

For complete parameter and response documentation, see TOOLS.md.


Setup

Connect via Claude.ai

  1. Go to claude.ai/settings/connectors
  2. Find SupaLedger in the Connectors Directory
  3. Click Connect
  4. Sign in with your SupaLedger credentials
  5. Select the organization you want Claude to access
  6. Click Allow

Connect via Claude Desktop

  1. Open Claude Desktop settings
  2. Navigate to MCP Servers
  3. Click Add Server
  4. Search for SupaLedger or enter the server URL:
    https://jztjsserurylfjqfbntx.supabase.co/functions/v1/mcp-server/mcp
    
  5. Complete the OAuth sign-in flow
  6. Start asking questions about your business

Connect via Claude Code (CLI)

claude mcp add supaledger -t http \
  https://jztjsserurylfjqfbntx.supabase.co/functions/v1/mcp-server/mcp

Example Prompts

Once connected, try these prompts in any Claude client:

1. Discover your organizations

"What organizations do I have access to?"

Claude calls platform_get_org_context and returns a list of your SupaLedger organizations with their active modules and key metrics.

2. Check your books

"What's Demo Corp's trial balance?"

Claude calls accounting_get_trial_balance and confirms whether debits equal credits, with totals broken down by account type.

3. Review your financial position

"Show me the balance sheet for Demo Corp"

Claude calls accounting_get_balance_sheet and presents your assets, liabilities, equity, and retained earnings.


Authentication

SupaLedger uses OAuth 2.0 (via Supabase Auth) for authentication. When you connect for the first time:

  1. You sign in with your SupaLedger email and password
  2. You choose which organization to grant access to
  3. You review the permissions and click Allow
  4. Claude receives a scoped, time-limited access token
  5. Tokens refresh automatically — you do not need to reconnect

Claude never sees your SupaLedger password. The OAuth flow is standard PKCE with no long-lived secrets stored on the client.


Data Handling

Policy Details
Default mode Summary — aggregated totals only, no PII
Detail mode Available on request — includes individual account names and contact details
Read-only Claude cannot create, modify, or delete any data
HIPAA exclusion Organizations flagged as HIPAA-regulated are automatically blocked from MCP access
Data transit Responses pass through Anthropic's infrastructure to generate Claude's answer
No training SupaLedger does not use your data for AI training
Audit logged Every tool call is logged (tool name, timestamp, success/failure) — not the response data

For the full privacy policy, visit supaledger.com/privacy.


How to Disconnect

From SupaLedger:

  1. Log in to SupaLedger
  2. Go to Settings > Connected Apps
  3. Click Disconnect next to Claude

From Claude:

  1. Go to your Claude settings
  2. Navigate to Connectors or MCP Servers
  3. Remove the SupaLedger connector

Disconnecting revokes Claude's access immediately. Your data remains untouched in your SupaLedger account.


Technical Details

Property Value
Transport Streamable HTTP (MCP 2025-03-26)
Server version 1.0.0
Runtime Supabase Edge Functions (Deno)
Auth OAuth 2.0 with PKCE
Tools 7 read-only
Annotations readOnlyHint: true, destructiveHint: false, idempotentHint: true on all tools

Support

For questions, issues, or feedback:


License

Copyright 2026 Field Elevate Management LLC. All rights reserved.

This MCP server is proprietary software. See LICENSE for details.

About

No description, website, or topics provided.

Resources

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors