Getting started

Appenda is a local-first encrypted spreadsheet. Agents inspect and modify your GTM data only through bounded appenda.* tools — not the filesystem or shell.

Prerequisites

Appenda desktop installed and a workspace unlocked
Cursor, Codex, or Claude Code with MCP support

Pick your integration

MCP (today) — agents call tools through the desktop agent gateway while the app is running. See Connect with MCP.

REST API (preview) — the hosted Table API at api.appenda.ai mirrors the same tool shapes. Browse the contract on Table API before cloud sync ships.

First workflow

appenda.list_tables — discover table ids
appenda.table_profile — read columns and field_id values for filters
appenda.count_rows— answer "how many?" with a structured FilterSpec (no row data returned)

{
  "table_id": "accounts",
  "filter": {
    "root": {
      "combinator": "and",
      "items": [{
        "field_id": "field_accounts_job_title",
        "operator": "contains",
        "value": { "kind": "text", "value": "founder" }
      }]
    }
  }
}

Which tool when

count_rows — compound AND/OR analytics
group_counts— one-field breakdowns ("count per industry")
search_cells — substring search in named columns
table_window — small row samples after count confirms size

Approvals

Read tools run after per-table approval in the desktop app. Mutating tools (e.g. row deletion) require explicit confirmation — details in the MCP guide.