Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to ChMeetings

Scalekit connector
Open markdown

The ChMeetings connector lets your AI agent act in each user's ChMeetings account. Each user connects their own ChMeetings API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 60 tools.

Tools
60
What they doRead · write · destructive
33 · 19 · 833 read19 write8 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the ChMeetings connection

    In AgentKit > Connections, create a ChMeetings connection. The name you give it is the connection_name your code passes. See Configure connections.

  4. Authorize a user and make your first call

    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENVIRONMENT_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'chmeetings'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize ChMeetings:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'chmeetings_accounting_accounts_list',
    toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user opens the link once and enters their ChMeetings credentials there. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • chmeetings_accounting_accounts_listList the ledger accounts (bank registers), optionally with their current balance.Read-only

    List Accounting Accounts

    List the ledger accounts (bank registers), optionally with their current balance. Returns a page of accounts with ID, name, type (asset or liability) and, with include=balance, the running balance. Use chmeetings_accounting_accounts_list for account balances and IDs. Use chmeetings_accounting_transactions_list for activity. Needs the API key scope accounting:read.

    Inputs

    includestring
    Set to balance to include each account's current running balance. Example: balance
    include_archivedboolean
    Include archived accounts. Default: false. Example: false
    pageinteger
    Page number to return, starting at 1. Example: 1default 1
    page_sizeinteger
    Number of items per page, from 1 to 100. Example: 50default 100
    typestring
    Filter by account type. Accepted values: asset, liability. One of: asset, liability. Example: assetone of assetliability
  • chmeetings_accounting_categories_listList the income and expense categories of the ledger.Read-only

    List Accounting Categories

    List the income and expense categories of the ledger. Returns a page of categories with ID, name, type and parent_category_id (at most two levels). Use chmeetings_accounting_categories_list to get category IDs for filtering chmeetings_accounting_transactions_list. Needs the API key scope accounting:read.

    Inputs

    include_archivedboolean
    Include archived categories. Default: false. Example: false
    pageinteger
    Page number to return, starting at 1. Example: 1default 1
    page_sizeinteger
    Number of items per page, from 1 to 100. Example: 50default 100
    searchstring
    Text to filter categories by name (contains match). Example: Utilities
    typestring
    Filter by category type. Accepted values: income, expense. One of: income, expense. Example: expenseone of incomeexpense
  • chmeetings_accounting_transactions_listList general-ledger transactions with their split lines, newest first, filtered by account, date range, type, categories, funds, payee, check number, text or amount.Read-only

    List Accounting Transactions

    List general-ledger transactions with their split lines, newest first, filtered by account, date range, type, categories, funds, payee, check number, text or amount. Returns a page of transactions; amounts are positive and type (income or expense) gives the direction. Use chmeetings_accounting_transactions_list for the church's books. Use chmeetings_contributions_list for donor giving. Needs the API key scope accounting:read.

    Inputs

    account_idinteger
    Filter to a single account's register. Example: 4
    category_idsstring
    Comma-separated category IDs; matches transactions with at least one line in any of them (e.g. "12" or "12,34"). At most 100 IDs. Example: 12,34
    check_nostring
    Filter by check number (contains match). Example: 1042
    fromstring
    Start of the transaction-date range (inclusive). Format: yyyy-MM-dd, church-local. Example: 2026-01-01
    fund_idsstring
    Comma-separated fund IDs; matches transactions with at least one line in any of them (e.g. "3" or "3,7"). At most 100 IDs. Example: 3,7
    include_beginning_balancesboolean
    Include beginning-balance (opening-balance) transactions. Default: true; each row carries is_beginning_balance. Example: true
    include_voidedboolean
    Include voided transactions. Voided rows contribute zero to every balance and are hidden by default. Example: false
    max_amountnumber
    Maximum transaction amount (amounts are positive; direction comes from type). Example: 5000
    min_amountnumber
    Minimum transaction amount (amounts are positive; direction comes from type). Example: 50
    pageinteger
    Page number to return, starting at 1. Example: 1default 1
    page_sizeinteger
    Number of items per page, from 1 to 100. Example: 50default 100
    payee_idinteger
    Filter by payee. Example: 55
    searchstring
    Text search across the transaction memo and line notes (contains match). Example: utilities
    tostring
    End of the transaction-date range (inclusive). Format: yyyy-MM-dd, church-local. Example: 2026-01-31
    typestring
    Filter by transaction type. Accepted values: income, expense. One of: income, expense. Example: expenseone of incomeexpense
  • chmeetings_campaign_pledges_listList the pledges made to a campaign.Read-only

    List Campaign Pledges

    List the pledges made to a campaign. Returns a page of pledges with the person, pledged amount and amount given so far. Use chmeetings_campaign_pledges_list to track campaign progress. Use chmeetings_contributions_list for actual gifts. Needs the API key scope contributions:read.

    Inputs

    campaign_idintegerrequired
    Campaign ID, as returned by chmeetings_campaigns_list. Example: 17
    pageinteger
    Page number to return, starting at 1. Example: 1default 1
    page_sizeinteger
    Number of items per page, from 1 to 100. Example: 50default 100
  • chmeetings_campaigns_listList pledge campaigns.Read-only

    List Campaigns

    List pledge campaigns. Returns a page of campaigns with ID, name, dates and goal. Use chmeetings_campaigns_list to find a campaign ID for chmeetings_campaign_pledges_list. Needs the API key scope contributions:read.

    Inputs

    pageinteger
    Page number to return, starting at 1. Example: 1default 1
    page_sizeinteger
    Number of items per page, from 1 to 100. Example: 50default 100
  • chmeetings_contribution_batches_listList contribution batches.Read-only

    List Contribution Batches

    List contribution batches. Returns a page of batches with ID, name, date, status and totals. Use chmeetings_contribution_batches_list to find a batch ID for chmeetings_contribution_create or chmeetings_contributions_list. Needs the API key scope contributions:read.

    Inputs

    pageinteger
    Page number to return, starting at 1. Example: 1default 1
    page_sizeinteger
    Number of items per page, from 1 to 100. Example: 50default 100
  • chmeetings_contribution_funds_listList giving funds (such as General Fund or Missions), optionally filtered by name or tax-deductibility.Read-only

    List Contribution Funds

    List giving funds (such as General Fund or Missions), optionally filtered by name or tax-deductibility. Returns a page of funds with ID, name, default flag and online-giving flag. Use chmeetings_contribution_funds_list to get fund IDs for chmeetings_contribution_create. Use chmeetings_accounting_transactions_list for the general ledger. Needs the API key scope contributions:read.

    Inputs

    is_tax_deductibleboolean
    true returns only tax-deductible funds, false only non-deductible ones. Example: true
    pageinteger
    Page number to return, starting at 1. Example: 1default 1
    page_sizeinteger
    Number of items per page, from 1 to 100. Example: 50default 100
    search_textstring
    Text to filter funds by name (contains match). Example: Missions
  • chmeetings_contributions_listList contributions (donations), filtered by person, date range, batch, reference ID or organization.Read-only

    List Contributions

    List contributions (donations), filtered by person, date range, batch, reference ID or organization. Returns a page of contributions with date, giver, amount per fund, payment method and batch. Use chmeetings_contributions_list for giving history. Use chmeetings_campaign_pledges_list for pledges. Needs the API key scope contributions:read.

    Inputs

    batch_idinteger
    Returns only the contributions in this batch. Use the batch id from GET /contributions/batches (the same value returned as batch_id on each contribution), not the batch number. Example: 301
    end_datestring
    End of the contribution date range. Format: yyyy-MM-dd. Example: 2026-01-31
    organization_idstring
    Returns only the contributions owned by this organization (the church or one of its ministries). Use an id from GET /organizations. Example: 12345
    pageinteger
    Page number to return, starting at 1. Example: 1default 1
    page_sizeinteger
    Number of items per page, from 1 to 100. Example: 50default 100
    person_idinteger
    Only contributions given by this person. Example: 1024567
    reference_idstring
    Only the contribution with this client reference ID. Example: stripe-ch_3Nx
    start_datestring
    Start of the contribution date range. Format: yyyy-MM-dd. Example: 2026-01-01