> For the complete documentation index, see [llms.txt](https://help.digits.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.digits.com/business-connections/digits-mcp.md).

# Digits Model Context Protocol (MCP)

Connect Digits to your favorite AI assistant to explore your financial data, pull reports, run scenarios, and make changes in the books. Just sign in and start asking.

***

<div align="left"><figure><img src="https://757481048-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FP19jknnpoCfbiUsJMprZ%2Fuploads%2FgB8YI1mzKiQfLFBVnlAE%2FDigits_Blog_Outcome-Based-Pricing-Announcement-Cover%402x.png?alt=media&#x26;token=f96320bc-4be3-4547-8b12-259b9825e1d3" alt="" width="563"><figcaption></figcaption></figure></div>

### What is MCP?

MCP helps AI tools, like Claude or ChatGPT, connect to apps like Digits so they can work with your data safely.

The Digits MCP lets your AI assistant connect to your financial data in Digits. You don’t need to set anything complicated up.

Once it’s connected, you can ask questions like “How much did I spend last month?” and your AI assistant will use your Digits data to find the answer. You can also ask it to do things, like “Move these three Uber charges to Travel” or “Draft an invoice to Acme for $1,200,” and it will make the change in Digits.

{% hint style="info" icon="glasses" %}
The Digits MCP server can **read and write**. Your AI assistant can look up your data, and it can create, edit, and delete transactions, invoices, bills, and categories. Every change runs as you, with the same permissions your Digits account already has. If you can't do something in Digits, your AI can't either.
{% endhint %}

***

### Connect to Digits' MCP Server

Connect Digits to your AI tool using the steps below. Each tool may look a little different, but they all use the same link:

`https://api.digits.com/mcp`

You will sign in with your existing Digits account during setup. No API keys or developer accounts are needed.

{% tabs %}
{% tab title="Claude Desktop" %}

#### How to Connect Digits to Claude <a href="#how-to-connect-digits-to-claude" id="how-to-connect-digits-to-claude"></a>

1. Open the Digits connector in Claude's directory: <https://claude.ai/directory/connectors/digits>
2. Click **Connect**
3. Authorize with your existing Digits account when prompted
4. Start a new chat. Claude can now access your Digits data
   {% endtab %}

{% tab title="Claude Code (CLI)" %}

#### Claude Code (CLI)

1. Open your terminal and run the following command:

```
claude mcp add --transport streamable-http digits https://api.digits.com/mcp
```

1. Authorize OAuth with your Digits account when prompted
2. Start a new conversation, and Claude Code will now have access to your Digits data
   {% endtab %}

{% tab title="OpenAI/ ChatGPT" %}

### How to Connect Digits to OpenAI/ ChatGPT

1. Open the Digits app in the OpenAI marketplace: <https://chatgpt.com/apps/digits/asdk_app_69cb30d03fe48191b9708242870b5fff>
2. Click **Install**
3. Authorize with your existing Digits account when prompted
4. Start a new chat, select the Digits app, and start asking questions
   {% endtab %}

{% tab title="Cursor" %}

1. In your Cursor IDE, go to Cursor → Settings → Cursor Settings
2. Go to Tools & MCPs and “Add Custom MCP”, which will open or create the file `~/.cursor/mcp.json`
3. Add the following configuration:

`{`\
`"mcpServers": {`\
`"digits": {`\
`"url": "https://api.digits.com/mcp"`\
`}`\
`}`\
`}`

4. Restart Cursor and authorize OAuth with your Digits account when prompted
   {% endtab %}

{% tab title="Perplexity" %}

1. Open Perplexity on the web and go to Settings
2. Navigate to the **MCP Servers** section under Labs/Features
3. Click **Add Connector**
   1. Name: **Digits**
   2. URL: `https://api.digits.com/mcp`
4. Click **Save** and authorize OAuth with your Digits account
5. Click **+** (plus) to enable Digits in the chat UI and start a new thread
   {% endtab %}
   {% endtabs %}

***

### What You Can Do With MCP

Once connected, ask a question about a specific account, and your AI assistant will use your Digits data to find the answer.

**Search for transactions**

> *"Show me all transactions from Chase credit card in February."*

**Access your financial statements**

> *"Show me my most recent P\&L statement."*

**Analyze your financials**

> *"How much did salary expense increase year over year?”*

**Work through scenarios**

> *"If we cut expenses by 10%, what would net income look like?”*

**Look up customers or vendors**

> *“Who are the top 5 vendors by spend this quarter?”*

**Review departments and locations**

> *“Break down revenue by department in Q1.”*

**Check on bills and invoices**

> *“Which invoices are still unpaid, and which bills are waiting on approval?”*

***

### What Your AI Assistant Can Change

Your AI assistant can also make changes in Digits. It only acts when you ask it to, and it uses the same permissions you have when you're signed in. Review what it did the same way you'd review a colleague's work.

**Fix categorization**

> *“Recategorize every Stripe fee in September from Software to Merchant Fees.”*

**Book journal entries**

> *“Create a $2,400 accrual for October rent, debit Rent and credit Accrued Expenses.”*

**Draft invoices**

> *“Draft an invoice to Acme Co. for 10 hours of consulting at $150 an hour, due in 30 days.”*

**Prepare bills**

> *“Create a bill from this vendor invoice and assign it to Office Supplies.”*

**Maintain the chart of accounts**

> *“Add a Contractor Labor category under Cost of Labor, then move these five transactions into it.”*

**Locked periods**

Locked Periods and the write tools launch together, and they work as a pair. If your AI assistant tries to change a transaction in a locked period, Digits turns the change into a proposal instead of applying it. An approver reviews it in Checklist → Locked Periods, and the books don't change until they approve. This applies to everyone, including approvers. See [Locking & Unlocking Periods](https://help.digits.com/business-agentic-general-ledger/close-date).

{% hint style="warning" %}
**What it won't do.** Your AI assistant creates invoices and bills as **Drafts**. It can't send an invoice to a customer, pay a bill, or move money. It can't change amounts or dates on transactions synced from a bank, and it can't edit a sent invoice beyond recategorizing its lines. For those, finish the job in Digits.
{% endhint %}

***

### Available Tools

The Digits MCP server gives your AI assistant access to a set of tools.

You do not need to use these tools yourself. Your AI assistant will automatically choose the right one based on your question.

**Tools that read your data**

<table data-search="false"><thead><tr><th width="218.87213134765625">Tool</th><th>What it does</th></tr></thead><tbody><tr><td><strong>list_businesses</strong></td><td>Lists all businesses you have access to in Digits, including both direct and affiliated entities.</td></tr><tr><td><strong>select_business</strong></td><td>Selects a specific business to work with for subsequent queries.</td></tr><tr><td><strong>list_business_users</strong></td><td>Lists all users who have access to a given business.</td></tr><tr><td><strong>query_transactions</strong></td><td>Searches and filters individual transactions with flexible options including date ranges, amounts, parties, and categories.</td></tr><tr><td><strong>search_term</strong></td><td>Resolves customer, vendor, category, department, or location names using fuzzy text matching.</td></tr><tr><td><strong>list_departments</strong></td><td>Lists all departments and their identifiers for a business.</td></tr><tr><td><strong>list_locations</strong></td><td>Lists all locations and their identifiers for a business.</td></tr><tr><td><strong>list_categories</strong></td><td>Lists all account categories and their types for a business.</td></tr><tr><td><strong>dimensional_summarize_transactions</strong></td><td>Aggregates transactions into multi-dimensional summaries, for example spending by category over time, or revenue by customer per quarter.</td></tr><tr><td><strong>financial_statement</strong></td><td>Generates complete financial statements: Profit &#x26; Loss, Balance Sheet, Cash Flow, and AR/AP Aging reports. Supports filtering by category, by one or more departments, and by one or more locations, so you can request a department- or location-specific P&#x26;L. Additional options include comparison lookback periods, showing account numbers, and fiscal-year start month</td></tr><tr><td><strong>list_transactions</strong></td><td>Lists individual transactions over a date range with filters for category, party, amount, department, location, and more.</td></tr><tr><td><strong>read_transaction</strong></td><td>Reads one transaction by its ID or a pasted transaction link.</td></tr><tr><td><strong>list_invoices</strong></td><td>Lists invoices created in Digits, filtered by status (pending, paid, voided, or all) or by customer.</td></tr><tr><td><strong>read_invoice</strong></td><td>Reads one invoice in full, including line items and discounts.</td></tr><tr><td><strong>list_invoice_customers</strong></td><td>Lists the invoice customers set up for a business.</td></tr><tr><td><strong>list_connect_invoices</strong></td><td>Lists invoices synced in from another system through a Connect integration, such as QuickBooks.</td></tr><tr><td><strong>list_bills</strong></td><td>Lists bills in Digits Bill Pay, including drafts, filtered by status or vendor.</td></tr><tr><td><strong>read_bill</strong></td><td>Reads one bill, including its lines, dates, vendor, and status.</td></tr><tr><td><strong>list_bill_vendors</strong></td><td>Finds vendors in Digits Bill Pay by name or email.</td></tr></tbody></table>

**Tools that make changes**

These tools run as you. Each one is limited to what your Digits role allows, and your AI assistant will tell you if a change was rejected.

<table data-search="false"><thead><tr><th width="218.87213134765625">Tool</th><th>What it does</th></tr></thead><tbody><tr><td><strong>update_transaction_fields</strong></td><td>Recategorizes existing transactions. Changes the category, vendor or customer, department, location, or tax status on up to 100 transactions at a time. Never changes amounts or dates. Works on bank-synced transactions.</td></tr><tr><td><strong>create_transactions</strong></td><td>Creates manual journal entries. Each entry needs balanced debit and credit lines.</td></tr><tr><td><strong>update_transaction</strong></td><td>Rewrites a manual journal entry: its date, memo, amounts, and lines. Only works on entries created manually, not on transactions synced from a bank or QuickBooks.</td></tr><tr><td><strong>delete_transactions</strong></td><td>Deletes transactions. Both sides of a journal entry are removed together. Can't delete scheduled or QuickBooks-sourced transactions.</td></tr><tr><td><strong>create_invoice</strong></td><td>Creates a new invoice as a Draft. It isn't emailed and doesn't post to the books until you send it from Digits.</td></tr><tr><td><strong>update_invoice</strong></td><td>Edits a Draft invoice. Sent invoices can't be edited this way, but their line items can be recategorized with update_transaction_fields.</td></tr><tr><td><strong>duplicate_invoice</strong></td><td>Creates a new Draft copy of an existing invoice.</td></tr><tr><td><strong>void_invoice</strong></td><td>Voids a sent invoice, reversing it in the books. Can include an internal note.</td></tr><tr><td><strong>delete_invoice</strong></td><td>Deletes a Draft invoice. Sent invoices must be voided instead.</td></tr><tr><td><strong>create_bill</strong></td><td>Creates a new bill as a Draft. Doesn't approve, pay, or post it.</td></tr><tr><td><strong>update_bill</strong></td><td>Edits a Draft bill. Bills past Draft must be edited in Digits.</td></tr><tr><td><strong>approve_bill</strong></td><td>Approves a bill, which posts it to the books. You must have approval permission and be an assigned approver on that bill. Doesn't schedule or send a payment.</td></tr><tr><td><strong>delete_bill</strong></td><td>Deletes a bill where Bill Pay permissions and the bill's status allow it. Doesn't cancel payments.</td></tr><tr><td><strong>create_bill_vendor</strong></td><td>Adds a vendor to Bill Pay by name and email. Doesn't send an invitation or set up bank details.</td></tr><tr><td><strong>create_category</strong></td><td>Adds a category to the chart of accounts under an existing parent.</td></tr><tr><td><strong>update_category</strong></td><td>Renames a category or changes its number, description, parent, type, or subtype.</td></tr><tr><td><strong>set_category_status</strong></td><td>Turns a category on or off. Categories can't be deleted, so turning one off is how it's retired.</td></tr><tr><td><strong>propose_locked_period_change</strong></td><td>Proposes a create, edit, recategorization, or deletion for transactions in a locked period. Nothing changes until an approver approves the proposal in Digits.</td></tr></tbody></table>

***

### Frequently Asked Questions

<details>

<summary>What is MCP?</summary>

The Model Context Protocol (MCP) is an open standard that lets AI assistants connect to external tools and data sources. It allows your AI assistant to securely access your Digits data without requiring you to copy and paste information back and forth.

</details>

<details>

<summary>Do I need a developer account to use the Digits MCP server?</summary>

No. The Digits MCP server uses your regular Digits login. You do not need to create an app, register as a developer, or set up API keys. Just connect and sign in with your existing Digits account.

</details>

<details>

<summary>Why can't I log in to the Digits MCP?</summary>

Make sure you're signing in with the same email and credentials you use to log in to Digits. If you continue to have issues, contact <support@digits.com>.

</details>

<details>

<summary>Can I write back to Digits from the MCP?</summary>

Yes. Your AI assistant can create, edit, and delete transactions, draft and void invoices, draft and approve bills, add vendors, and manage categories. Every change runs under your user with your permissions. It can't send invoices or pay bills, and changes to a locked period go through approval first.

</details>

<details>

<summary>Do I need to reconnect to get the write tools?</summary>

No. The new tools appear in your existing connection. If your AI tool caches the tool list, start a new chat.

</details>

<details>

<summary>Can my AI assistant see bills and invoices in Digits?</summary>

Yes. It can list and read invoices created in Digits, invoices synced through a Connect integration, bills in Digits Bill Pay, and customer and vendor invoices. You can also still use the AR/AP Aging financial statements for a summary of what's outstanding.

</details>

<details>

<summary>Can my AI assistant send an invoice or pay a bill?</summary>

No. Invoices and bills it creates are Drafts. Sending an invoice, approving a payment, and withdrawing funds all happen in Digits. Approving a bill through your AI posts it to the books but doesn't schedule a payment.

</details>

<details>

<summary>Can my AI assistant change transactions in a locked period?</summary>

Not directly. When your AI assistant tries to change a transaction in a locked period, Digits turns the change into a proposal. Nothing changes on the books until an approver reviews it in **Checklist** → **Locked Periods**. That's true even if you're an approver yourself. See [Locking & Unlocking Periods](https://help.digits.com/business-agentic-general-ledger/close-date).

</details>

<details>

<summary>What if I don't want my AI assistant making changes?</summary>

It only changes when you ask it to. Most AI tools also let you require approval before each action or turn individual Digits tools off in the connector settings. Check your AI tool's connector or MCP settings.

</details>

<details>

<summary>How do I see what my AI assistant changed?</summary>

It's in the history. Changes made by your AI assistant are logged under your name, in the same place as changes you make yourself. There is no separate AI log.

**To check a transaction:** open the transaction and click the **Activity Log** tab. You'll see "Edited this transaction" with your name and the time.

**To check an invoice or bill:** open it. The activity log on the right shows status changes, such as Voided or Approved, with your name.

**Categories** don't keep a history. Open Category Manager to see the current setup.

Not sure what your AI did? Ask it. It can list every change it made in the conversation.

</details>

<details>

<summary>Is the Digits MCP secure?</summary>

Yes. All transmitted data is encrypted and accessed only when explicitly requested by you.

</details>

<details>

<summary>Why is my Digits MCP connection stuck as "Requested"?</summary>

If your Digits MCP connection stays in **Requested**, your AI workspace administrator may need to approve the Digits connector.

This is common with managed Claude and other AI workspaces, where connectors require administrator approval before they can be used.

Ask your workspace administrator to approve the Digits connector in your AI provider's admin console. Once it's approved, reconnect or refresh your AI tool.

</details>

***

{% columns %}
{% column width="66.66666666666666%" valign="middle" %}
Got a question or feedback? Our team is all ears. Come say hello!
{% endcolumn %}

{% column width="33.33333333333334%" valign="middle" %}

<p align="center"><a href="https://portal.usepylon.com/digits/forms/get-in-touch-with-digits-support" class="button primary" data-icon="envelope-open-text">Contact Digits Support</a></p>
{% endcolumn %}
{% endcolumns %}

***


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.digits.com/business-connections/digits-mcp.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
