# Metronome

```json
{
  "name": "Metronome",
  "slug": "metronome",
  "url": "https://composio.dev/toolkits/metronome",
  "markdown_url": "https://composio.dev/toolkits/metronome.md",
  "logo_url": "https://logos.composio.dev/api/metronome",
  "categories": [
    "finance & accounting"
  ],
  "is_composio_managed": false,
  "updated_at": "2026-11-17T05:39:42.142Z"
}
```

![Metronome logo](https://logos.composio.dev/api/metronome)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Metronome MCP or direct API to manage customers, review contracts and pricing, track usage and credits, and handle invoices through natural language.

## Summary

Metronome is a usage-based billing platform for customers, contracts, pricing, usage, credits, and invoices.
It helps finance and product teams automate accurate billing as usage changes.

## Categories

- finance & accounting

## Toolkit Details

- Tools: 118

## Images

- Logo: https://logos.composio.dev/api/metronome

## Authentication

- **Bearer Token**
  - Type: `bearer_token`
  - Description: Bearer Token authentication for Metronome.
  - Setup:
    - Configure Bearer Token credentials for Metronome.
    - Use the credentials when creating an auth config in Composio.

## Suggested Prompts

- List customers with overdue invoices
- Review active contracts and pricing plans
- Summarize usage credits by customer

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `METRONOME_ADD_MANUAL_BALANCE_LEDGER_ENTRY` | Add Manual Balance Ledger Entry | Manually increase or decrease an existing commit or credit balance segment. |
| `METRONOME_ADD_RATE` | Add Rate | Add one product rate to a Metronome rate card. Prefer Add Rates for bulk changes. |
| `METRONOME_ADD_RATES` | Add Rates | Add multiple product rates to a Metronome rate card in one request. |
| `METRONOME_ARCHIVE_ALERT` | Archive Alert | Permanently stop a threshold notification from evaluating, optionally releasing its uniqueness key for reuse. |
| `METRONOME_ARCHIVE_BILLABLE_METRIC` | Archive Billable Metric | Archive a Metronome billable metric. Archived metrics cannot be assigned to new products, and Metronome does not document a restore operation. |
| `METRONOME_ARCHIVE_COMMIT` | Archive Commit | Archive a customer commit so it is no longer active. |
| `METRONOME_ARCHIVE_CONTRACT` | Archive Contract | Permanently end and archive a contract and its terms, cancel draft invoices, void upcoming scheduled invoices, and optionally void existing finalized invoices. Active prepaid commit balances are closed and may receive expiration ledger entries. Requires the customer and contract IDs. |
| `METRONOME_ARCHIVE_CREDIT` | Archive Credit | Archive a customer credit so it is no longer active. |
| `METRONOME_ARCHIVE_CREDIT_TYPE` | Archive Pricing Unit | Archive a custom Metronome pricing unit so it no longer appears in pricing unit selectors by default. |
| `METRONOME_ARCHIVE_CUSTOMER` | Archive Customer | Permanently archive a Metronome customer and every customer contract, void the corresponding invoices, and stop associated notifications. Requires the customer ID and cannot be undone. |
| `METRONOME_ARCHIVE_CUSTOMER_BILLING_PROVIDER_CONFIGURATIONS` | Archive Customer Billing Provider Configurations | Archive one or more billing provider configurations for a Metronome customer. This immediately stops affected contracts from metering to downstream systems. |
| `METRONOME_ARCHIVE_NOTIFICATION_CONFIG` | Archive Notification Config | Archive an offset lifecycle-event notification configuration so Metronome no longer processes it. |
| `METRONOME_ARCHIVE_PACKAGE` | Archive Package | Permanently archive a package so it cannot be used to create new contracts. Existing contracts using the package continue to function. |
| `METRONOME_ARCHIVE_PRODUCT` | Archive Product | Archive a Metronome product so it cannot be used for new rates. Existing rate cards continue to function, and Metronome does not support unarchiving. |
| `METRONOME_ARCHIVE_RATE_CARD` | Archive Rate Card | Permanently archive a rate card so it cannot be used for new contracts. |
| `METRONOME_CREATE_ALERT` | Create Alert | Create a threshold notification that monitors customer spend, usage, credits, commits, invoice totals, or seat balances. |
| `METRONOME_CREATE_BILLABLE_METRIC` | Create Billable Metric | Create a streaming billable metric from event filters and aggregation rules, or create a SQL billable metric by supplying sql instead. |
| `METRONOME_CREATE_CONTRACT` | Create Contract | Create a Metronome contract with pricing, credits, commitments, subscriptions, and billing terms. |
| `METRONOME_CREATE_CREDIT_TYPE` | Create Pricing Unit | Create a custom Metronome pricing unit for charging usage in a non-fiat unit. |
| `METRONOME_CREATE_CUSTOMER` | Create Customer | Create a Metronome customer with optional usage aliases, custom fields, and billing or revenue system configurations. |
| `METRONOME_CREATE_CUSTOMER_COMMIT` | Create Customer Commit | Create a customer-level prepaid or postpaid commit with access and invoice schedules. |
| `METRONOME_CREATE_CUSTOMER_CREDIT` | Create Customer Credit | Create a customer-level credit with a scheduled spend or quantity balance. |
| `METRONOME_CREATE_CUSTOM_FIELD_KEY` | Create Custom Field Key | Create an allowed custom field key for a Metronome entity type and choose whether its values must be unique. |
| `METRONOME_CREATE_HISTORICAL_CONTRACT_USAGE_INVOICES` | Create Historical Contract Usage Invoices | Validate a read-only preview or create retroactive contract usage invoices for historical billing periods. Set preview=true for validation with no billing records created; set preview=false to create invoices. Because this single endpoint can create billing records, the action is classified as a create operation. |
| `METRONOME_CREATE_NOTIFICATION_CONFIG` | Create Notification Config | Create a notification that publishes a webhook at an ISO 8601 time offset from a Metronome lifecycle event. |
| `METRONOME_CREATE_PACKAGE` | Create Package | Create a reusable package of time-relative contract pricing and billing terms. |
| `METRONOME_CREATE_PRODUCT` | Create Product | Create a Metronome product representing an invoice line item, including its usage metric, composite behavior, quantity rules, tags, and custom fields. |
| `METRONOME_CREATE_RATE_CARD` | Create Rate Card | Create a Metronome rate card with pricing-unit conversions and scheduled aliases. |
| `METRONOME_DELETE_CUSTOM_FIELD_KEY` | Delete Custom Field Key | Remove a custom field key from a Metronome entity type's allowlist, making existing values for that key inaccessible. |
| `METRONOME_DELETE_CUSTOM_FIELDS` | Delete Custom Fields | Delete selected custom field values from one Metronome entity instance without changing its other custom fields. |
| `METRONOME_DISABLE_COMMIT_TRUEUP` | Disable Commit True-up | Disable generation of the final true-up invoice for a postpaid commit. |
| `METRONOME_EDIT_COMMIT` | Edit Commit | Edit a commit's metadata, schedules, applicability, product, rate, priority, or hierarchy access. |
| `METRONOME_EDIT_CONTRACT` | Edit Contract | Apply a v2 contract edit that adds, updates, archives, or removes contract terms. |
| `METRONOME_EDIT_CREDIT` | Edit Credit | Edit a credit's metadata, access schedule, applicability, product, rate, priority, or hierarchy access. |
| `METRONOME_EDIT_NOTIFICATION_CONFIG` | Edit Notification Config | Change an offset notification policy or enable or disable webhook publishing for a system lifecycle notification. |
| `METRONOME_GET_AUDIT_LOGS` | Get Audit Logs | Get one page of account audit entries for security monitoring, compliance, and operational investigation. |
| `METRONOME_GET_BILLABLE_METRIC` | Get Billable Metric | Retrieve one Metronome billable metric by ID, including its event matching, aggregation, grouping, custom fields, SQL, and archive state. |
| `METRONOME_GET_CONTRACT` | Get Contract | Retrieve the current or historical v2 configuration of a Metronome contract. |
| `METRONOME_GET_CONTRACT_EDIT_HISTORY` | Get Contract Edit History | List all recorded edits made to a Metronome contract over time. |
| `METRONOME_GET_CONTRACT_NAMED_SCHEDULE` | Get Contract Named Schedule | Get the segments of a named schedule for a customer's Metronome contract, optionally selected by date and schedule properties. |
| `METRONOME_GET_CONTRACT_RATE_SCHEDULE` | Get Contract Rate Schedule | Get one page of entitled contract rates at a point in time, including contract overrides. |
| `METRONOME_GET_CUSTOMER` | Get Customer | Get a Metronome customer by ID, including aliases, configuration, and custom fields. |
| `METRONOME_GET_CUSTOMER_ALERT` | Get Customer Alert | Get a threshold notification's configuration and current evaluation status for a specific customer. |
| `METRONOME_GET_CUSTOMER_BILLING_PROVIDER_CONFIGURATIONS` | Get Customer Billing Provider Configurations | Fetch active or archived billing provider configurations for a customer. |
| `METRONOME_GET_CUSTOMER_NAMED_SCHEDULE` | Get Customer Named Schedule | Get the segments of a named schedule configured for a Metronome customer, optionally restricted to the segment covering a date. |
| `METRONOME_GET_CUSTOMER_REVENUE_SYSTEM_CONFIGURATIONS` | Get Customer Revenue System Configurations | Fetch revenue system configurations for a Metronome customer. |
| `METRONOME_GET_EMBEDDABLE_DASHBOARD_URL` | Get Embeddable Dashboard URL | Create a secure, time-limited URL for a user-facing customer Metronome dashboard. This returns an embeddable human interface, not dashboard data the agent can inspect; use invoice, usage, commit, or credit read actions when structured data is needed. |
| `METRONOME_GET_INVOICE` | Get Invoice | Retrieve one Metronome customer invoice by ID, including its line items and external billing status. |
| `METRONOME_GET_INVOICE_PDF` | Get Invoice PDF | Download a Metronome invoice PDF and return an offloaded file reference. |
| `METRONOME_GET_NET_BALANCE` | Get Net Balance | Get the combined current balance across a filtered set of customer commits and credits. |
| `METRONOME_GET_NOTIFICATION_CONFIG` | Get Notification Config | Retrieve an offset lifecycle-event notification configuration by ID. |
| `METRONOME_GET_PACKAGE` | Get Package | Get one package's name, alias schedule, duration, commits, credits, overrides, scheduled charges, and contract defaults. |
| `METRONOME_GET_PAGED_USAGE` | Get Grouped Usage Data | Return one page of usage for one customer and billable metric, optionally grouped and filtered by a complete simple or compound metric group key. |
| `METRONOME_GET_PRODUCT` | Get Product | Get a Metronome product by ID, including its current and initial configuration, historical updates, archive state, and custom fields. |
| `METRONOME_GET_RATE_CARD` | Get Rate Card | Get one rate card's metadata, pricing unit, conversions, aliases, and custom fields. |
| `METRONOME_GET_RATE_CARD_NAMED_SCHEDULE` | Get Rate Card Named Schedule | Get the segments of a named schedule configured on a Metronome rate card, optionally restricted to the segment covering a date. |
| `METRONOME_GET_RATES` | Get Rates | Get one page of rate-card prices active at a specific timestamp. |
| `METRONOME_GET_RATE_SCHEDULE` | Get Rate Schedule | Get one page of scheduled rate-card prices over a requested time window. |
| `METRONOME_GET_SERVICES` | Get Services | Get Metronome's service registry and current IP addresses for firewall and network allowlist configuration. |
| `METRONOME_GET_SUBSCRIPTION_QUANTITY_HISTORY` | Get Subscription Quantity History | Retrieve historical subscription quantities and prices for a contract subscription. |
| `METRONOME_GET_SUBSCRIPTION_SEATS_HISTORY` | Get Subscription Seats History | Get one page of historical seat assignments and quantities for a contract subscription. |
| `METRONOME_GET_USAGE_BATCH` | Get Batched Usage Data | Return one page of usage aggregated across customers and billable metrics for hourly, daily, or whole-period reporting. |
| `METRONOME_GET_WEBHOOK_DELIVERY` | Get Webhook Delivery | Retrieve one triggered Metronome webhook notification, its exact JSON payload, and every recorded delivery attempt. |
| `METRONOME_INGEST_USAGE_EVENTS` | Ingest Usage Events | Ingest one to 100 usage events that immediately affect customer usage, spend, and billing. Use globally unique transaction IDs; Metronome ignores duplicates for 34 days and accepts events backdated by at most 34 days. |
| `METRONOME_LIST_BILLABLE_METRICS` | List Billable Metrics | List billable metric definitions, optionally including archived metrics, for pricing and event-matching discovery. |
| `METRONOME_LIST_BILLING_PROVIDERS` | List Billing Providers | List account-level billing providers and their delivery-method configurations. |
| `METRONOME_LIST_BREAKDOWN_INVOICES` | List Invoice Breakdowns | List hourly or daily invoice breakdowns for a Metronome customer and time range. |
| `METRONOME_LIST_CONTRACTS` | List Contracts | List one page of a customer's current v2 contracts with optional balances, ledgers, and archive filters. |
| `METRONOME_LIST_CONTRACTS_NAMED_SCHEDULES` | List Contract Named Schedules | List one page of contract-level named schedules for a Metronome customer, with optional contract, name, property, and date filters. |
| `METRONOME_LIST_CONTRACTS_ON_PACKAGE` | List Contracts On Package | List one page of customer contracts provisioned from a package over a selected time period. |
| `METRONOME_LIST_CUSTOMER_ALERTS` | List Customer Alerts | List one page of threshold notifications and their current evaluation statuses for a customer. |
| `METRONOME_LIST_CUSTOMER_BALANCES` | List Customer Balances | List one page of a customer's current commit and credit balances. |
| `METRONOME_LIST_CUSTOMER_BILLABLE_METRICS` | List Customer Billable Metrics | List billable metrics available for a Metronome customer, optionally filtering to the current plan or including archived metrics. |
| `METRONOME_LIST_CUSTOMER_COMMITS` | List Customer Commits | List one page of customer-level and optionally contract-level commits. |
| `METRONOME_LIST_CUSTOMER_CREDITS` | List Customer Credits | List one page of customer-level and optionally contract-level credits. |
| `METRONOME_LIST_CUSTOMERS` | List Customers | List active or archived Metronome customers, optionally filtering by customer, ingest, Salesforce, or Stripe identifiers. |
| `METRONOME_LIST_CUSTOM_FIELD_KEYS` | List Custom Field Keys | List active Metronome custom field keys, optionally filtered to selected entity types. |
| `METRONOME_LIST_HISTORICAL_BALANCES` | List Historical Balances | List one page of commits and credits moved to historical storage. |
| `METRONOME_LIST_INVOICES` | List Invoices | List one page of invoices for a Metronome customer with optional status, type, contract, credit type, and billing-period filters. |
| `METRONOME_LIST_OFFSET_NOTIFICATION_CONFIGS` | List Offset Notification Configs | List one page of user-created lifecycle-event notifications that publish webhooks before or after their base events. |
| `METRONOME_LIST_PACKAGES` | List Packages | List contract packages with their terms, commits, overrides, scheduled charges, and archive state. |
| `METRONOME_LIST_PRICING_UNITS` | List Pricing Units | List fiat and custom pricing units available for rates, credits, and commits. |
| `METRONOME_LIST_PRODUCTS` | List Products | List Metronome products and their current configuration, version history, metadata, and archive state. |
| `METRONOME_LIST_RATE_CARDS` | List Rate Cards | List rate cards with their IDs, names, descriptions, aliases, pricing units, and metadata. |
| `METRONOME_LIST_SEAT_BALANCES` | List Seat Balances | List one page of seat-level commit and credit balances for a contract. |
| `METRONOME_LIST_SPEND_BREAKDOWN_INVOICES` | List Spend Invoice Breakdowns | List one page of customer invoice spend breakdowns by time window and optional presentation groups. |
| `METRONOME_LIST_SYSTEM_NOTIFICATION_CONFIGS` | List System Notification Configs | List one page of Metronome system lifecycle notification types and whether their webhook publishing is enabled. |
| `METRONOME_LIST_WEBHOOK_DELIVERIES` | List Webhook Deliveries | List one page of triggered notifications and delivery summaries for a Metronome webhook destination from the last 30 days. |
| `METRONOME_MOVE_RATE_CARD_PRODUCTS` | Move Rate Card Products | Move selected products to new invoice-order positions on a rate card. |
| `METRONOME_PREVIEW_CUSTOMER_EVENTS` | Preview Customer Events | Calculate customer invoice previews from supplied usage events without ingesting the events. |
| `METRONOME_REGENERATE_INVOICE` | Regenerate Invoice | Regenerate a previously voided Metronome invoice using current rates, balances, and fees, distribute the replacement through the configured billing provider, and return its new invoice ID. This is a billing-impacting operation. |
| `METRONOME_RELEASE_EXTERNAL_PAYMENT_GATE_THRESHOLD_COMMIT` | Release External Payment Gate Threshold Commit | Complete or cancel a threshold commit after an external payment attempt. |
| `METRONOME_RESET_CUSTOMER_ALERTS` | Reset Customer Alerts | Clear a threshold notification's cached state for a customer and trigger an asynchronous re-evaluation. |
| `METRONOME_SCHEDULE_PRO_SERVICES_INVOICE` | Schedule Pro Services Invoice | Schedule an invoice for professional service terms on a contract. |
| `METRONOME_SEARCH_EVENTS` | Search Events | Retrieve recent usage events by transaction ID to sample ingestion, customer matching, metric matching, and duplicate handling. Metronome heavily rate limits this endpoint; use targeted samples rather than broad or repeated polling. |
| `METRONOME_SET_CUSTOMER_BILLABLE_STATUS` | Set Customer Billable Status | Set whether a Metronome customer is billable from a specified effective time. |
| `METRONOME_SET_CUSTOMER_BILLING_PROVIDER_CONFIGURATIONS` | Set Customer Billing Provider Configurations | Create one or more billing provider configurations for Metronome customers. |
| `METRONOME_SET_CUSTOMER_NAME` | Set Customer Name | Update the display name of a Metronome customer. |
| `METRONOME_SET_CUSTOMER_REVENUE_SYSTEM_CONFIGURATIONS` | Set Customer Revenue System Configurations | Create one or more revenue system configurations for Metronome customers. |
| `METRONOME_SET_CUSTOM_FIELDS` | Set Custom Fields | Transactionally set or overwrite custom field values on one Metronome entity instance while preserving unspecified fields. |
| `METRONOME_SET_INGEST_ALIASES` | Set Customer Ingest Aliases | Replace the complete set of usage ingest aliases for a Metronome customer. |
| `METRONOME_SET_RATE_CARD_PRODUCTS_ORDER` | Set Rate Card Products Order | Replace the complete invoice display order of products on a rate card. |
| `METRONOME_SET_UP_BILLING_PROVIDER` | Set Up Billing Provider | Set up account-level Metronome configuration for a marketplace billing provider. |
| `METRONOME_SET_USAGE_FILTER` | Set Usage Filter | Route a customer's grouped usage to a contract starting at a specified time. |
| `METRONOME_UPDATE_BILLABLE_METRIC` | Update Billable Metric | Rename an existing Metronome billable metric. Metronome does not allow this endpoint to change the metric's filtering or aggregation configuration. |
| `METRONOME_UPDATE_COMMIT_END_DATE` | Update Commit End Date | Update the access or invoice end date of a prepaid customer commit. |
| `METRONOME_UPDATE_CONTRACT_END_DATE` | Update Contract End Date | Set, move, or remove a contract's exclusive end timestamp. |
| `METRONOME_UPDATE_CONTRACT_NAMED_SCHEDULE` | Update Contract Named Schedule | Set a dated segment on a named schedule for a customer's Metronome contract. |
| `METRONOME_UPDATE_CREDIT_END_DATE` | Update Credit End Date | Update the access end date of a customer credit. |
| `METRONOME_UPDATE_CUSTOMER_CONFIG` | Update Customer Configuration | Update the Salesforce account configuration for a Metronome customer. |
| `METRONOME_UPDATE_CUSTOMER_NAMED_SCHEDULE` | Update Customer Named Schedule | Set a dated segment on a named schedule configured for a Metronome customer. |
| `METRONOME_UPDATE_INVOICE_ISSUE_DATE` | Update Invoice Issue Date | Reschedule the issue date of one draft contract invoice without changing future billing cycles. |
| `METRONOME_UPDATE_PRODUCT` | Update Product | Schedule a configuration update for a Metronome product without changing its type. The effective timestamp must be on an hour boundary. |
| `METRONOME_UPDATE_RATE_CARD` | Update Rate Card | Update a rate card's metadata, alias schedule, or pricing-unit conversions. |
| `METRONOME_UPDATE_RATE_CARD_NAMED_SCHEDULE` | Update Rate Card Named Schedule | Set a dated segment on a named schedule configured for a Metronome rate card. |
| `METRONOME_UPSERT_ANROK_API_TOKEN` | Upsert Anrok API Token | Set the Anrok API token used by specified Metronome billing delivery methods. |
| `METRONOME_UPSERT_AVALARA_CREDENTIALS` | Upsert Avalara Credentials | Set Avalara credentials for specified Metronome billing delivery methods. |
| `METRONOME_VOID_INVOICE` | Void Invoice | Permanently void a Metronome invoice. This destructive billing operation cannot be undone. |

## Supported Triggers

None listed.

## Installation and MCP Setup

### Path 1: SDK Installation

#### Path 1, Step 1: Install Composio

Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
```python
pip install composio composio_openai openai
```

```typescript
npm install @composio/core @composio/openai openai
```

#### Path 1, Step 2: Create a Composio session

Initialize Composio with the OpenAI Responses provider and create a session scoped to Metronome
```python
import json
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
client = OpenAI()

session = composio.create(user_id="your-user-id", toolkits=["metronome"])
tools = session.tools()
```

```typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["metronome"] });
const tools = await session.tools();
```

#### Path 1, Step 3: Run Metronome tools with your agent

Send a request, execute the Metronome tool calls through the session, and print the final answer
```python
response = client.responses.create(
    model="gpt-5.6-sol",
    tools=tools,
    input=[{"role": "user", "content": "List all customers in Metronome"}],
)

while True:
    tool_calls = [o for o in response.output if o.type == "function_call"]
    if not tool_calls:
        break
    results = composio.provider.handle_tool_calls(response=response, session=session)
    response = client.responses.create(
        model="gpt-5.6-sol",
        tools=tools,
        previous_response_id=response.id,
        input=[
            {"type": "function_call_output", "call_id": call.call_id, "output": json.dumps(results[i])}
            for i, call in enumerate(tool_calls)
        ],
    )

print(response.output_text)
```

```typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "List all customers in Metronome" }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
```

### Path 2: MCP Server Setup

#### Path 2, Step 1: Install Composio

Install the Composio SDK and your agent framework
```python
pip install composio claude-agent-sdk
```

```typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
```

#### Path 2, Step 2: Create a session with MCP enabled

Create a session scoped to Metronome and read its MCP URL and headers
```python
from composio import Composio

composio = Composio()
session = composio.create(user_id="your-user-id", toolkits=["metronome"], mcp=True)
```

```typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["metronome"],
  mcp: true,
});
```

#### Path 2, Step 3: Connect your agent to the MCP server

Pass the session's MCP URL and headers to your agent and run a Metronome request
```python
import asyncio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions, AssistantMessage, TextBlock

options = ClaudeAgentOptions(
    mcp_servers={
        "composio": {
            "type": "http",
            "url": session.mcp.url,
            "headers": session.mcp.headers,
        }
    },
    system_prompt="You are a helpful assistant with access to Metronome tools.",
    tools=[],
    allowed_tools=["mcp__composio__*"],
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query("List all customers in Metronome")
        async for message in client.receive_response():
            if isinstance(message, AssistantMessage):
                for block in message.content:
                    if isinstance(block, TextBlock):
                        print(block.text)

asyncio.run(main())
```

```typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "List all customers in Metronome",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
```

## Why Use Composio?

### 1. AI Native Metronome Integration

- Supports both Metronome MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable customer, billing, and usage tool execution
- Rich coverage for reading, writing, and querying your Metronome data

### 2. Managed Auth

- Connect your Metronome bearer token without writing custom authentication code
- Central place to securely store, scope, and revoke Metronome access
- Use separate credentials per user and environment instead of hard-coded tokens

### 3. Agent Optimized Design

- Tools are tuned using real error and success rates to improve reliability over time
- Comprehensive execution logs so you always know what ran, when, and on whose behalf

### 4. Enterprise Grade Security

- Fine-grained RBAC so you control which agents and users can access Metronome
- Scoped, least privilege access to Metronome resources
- Full audit trail of agent actions to support review and compliance

## Use Metronome with any AI Agent Framework

Choose a framework you want to connect Metronome with:

- [ChatGPT](https://composio.dev/toolkits/metronome/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/metronome/framework/claude-cowork)
- [Hermes](https://composio.dev/toolkits/metronome/framework/hermes-agent)
- [Atomic Agent](https://composio.dev/toolkits/metronome/framework/atomic-agent)

## Related Toolkits

- [Stripe](https://composio.dev/toolkits/stripe) - Stripe is a global online payments platform offering APIs for managing payments, customers, and subscriptions. Trusted by businesses for secure, efficient, and scalable payment processing worldwide.
- [44API](https://composio.dev/toolkits/44api) - 44API is an API service for validating VAT and tax identifiers and returning company details. Use it to verify business tax data and manage account IP whitelists quickly.
- [Airwallex](https://composio.dev/toolkits/airwallex) - Airwallex is a global financial platform providing business accounts, payments, payouts, FX, and cards. Built to simplify cross-border payments and streamline financial operations for businesses.
- [Aiwyn Tax MCP](https://composio.dev/toolkits/aiwyn_tax_mcp) - Aiwyn Tax MCP is a tax estimation service powered by Aiwyn's federal and state tax engine. It helps teams estimate tax outcomes without building tax calculation logic from scratch.
- [Alpaca](https://composio.dev/toolkits/alpaca) - Alpaca is a stock and crypto trading platform for commission-free trading, real-time market data, and algorithmic strategies. Use it to build brokerage apps, trading bots, and portfolio workflows with market connectivity.
- [Alpha vantage](https://composio.dev/toolkits/alpha_vantage) - Alpha Vantage is a financial data platform offering real-time and historical stock market APIs. Get instant, reliable access to equities, forex, and technical analysis data for smarter trading decisions.
- [Altoviz](https://composio.dev/toolkits/altoviz) - Altoviz is a cloud-based billing and invoicing platform for businesses. It streamlines online payments, expense tracking, and customizable invoice management.
- [Anrok](https://composio.dev/toolkits/anrok) - Anrok is a sales tax platform for software businesses that automates calculations, compliance, filings, and exemption management. It helps finance teams stay accurate and reduce the manual work of tax operations.
- [Benzinga](https://composio.dev/toolkits/benzinga) - Benzinga provides real-time financial news and data APIs for market coverage. It helps you track breaking news and actionable market insights instantly.
- [bexio](https://composio.dev/toolkits/bexio) - bexio is a Swiss business management platform for accounting, invoicing, contacts, projects, banking, expenses, and payroll. It brings core business operations into one connected workspace.
- [Bigdata.com MCP](https://composio.dev/toolkits/bigdata_com_mcp) - Bigdata.com MCP provides grounded access to financial news, transcripts, filings, and entity intelligence. Ideal for building research workflows and generating timely market insights.
- [Billsby](https://composio.dev/toolkits/billsby) - Billsby is a subscription billing platform for managing customers, subscriptions, invoices, products, plans, usage counters, add-ons, and allowances. It helps SaaS and subscription teams automate billing operations without building complex billing logic from scratch.
- [Brex](https://composio.dev/toolkits/brex) - Brex provides corporate credit cards and spend management tailored for startups and tech businesses. It helps optimize company cash flow, streamline accounting, and accelerate business growth.
- [Carta](https://composio.dev/toolkits/carta) - Carta is an equity management platform for cap tables, compensation, portfolios, and fund administration. It helps companies and investors manage ownership data and financial operations in one place.
- [Cashfree](https://composio.dev/toolkits/cashfree_payments_mcp) - Cashfree is a merchant payments platform that handles collection, payouts, subscriptions, settlements, refunds, and identity verification. Simplifies merchant money lifecycle management with unified, API-driven workflows.
- [Chaser](https://composio.dev/toolkits/chaser) - Chaser is accounts receivable automation software that sends invoice reminders and helps businesses get paid faster. It streamlines the collections process to save time and improve cash flow.
- [Clarity AI MCP](https://composio.dev/toolkits/clarity_ai_mcp) - Clarity AI MCP is an MCP toolkit for simulating SFDR 2.0 fund classifications from a fund name, ISIN, or CUSIP. Use it to tap Clarity AI disclosure data and modeling without building custom sustainability-data workflows.
- [Clientary](https://composio.dev/toolkits/clientary) - Clientary is a platform for managing clients, invoices, projects, proposals, and more. It streamlines client work and saves you serious admin time.
- [Coinbase](https://composio.dev/toolkits/coinbase) - Coinbase is a platform for buying, selling, and storing cryptocurrency. It makes exchanging and managing crypto simple and secure for everyone.
- [Coinbase Agents MCP](https://composio.dev/toolkits/coinbase_agents_mcp) - Coinbase Agents MCP is Coinbase's managed toolkit exposing accounts, portfolios, orders, fills, and market data. Use it to let authorized agents inspect holdings, execute trades, perform transfers, and handle payments.

## Frequently Asked Questions

### Do I need my own developer credentials to use Metronome with Composio?

Yes, Metronome requires you to configure your own bearer token credentials. Once set up, Composio handles secure token storage and lifecycle management for you.

### Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview).

### Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev).

### What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)
