DeepLedger MCP server
2026년 10월 5일 커밋QuickBooks를 AI agent에 연결하여 거래 기록, 재무 보고서 실행, 미수금 및 미지급금 관리, 월말 결산 처리를 수행합니다.
다른 이름 DeepLedger/deepledger-plugin, deepledger-plugin
- 스타
- 1
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- 1.0.10
- 마지막 커밋
- 2026년 10월 5일
- 라이선스
- MIT
DeepLedger MCP란?
DeepLedger은(는) MCP server입니다. QuickBooks를 AI agent에 연결하여 거래 기록, 재무 보고서 실행, 미수금 및 미지급금 관리, 월말 결산 처리를 수행합니다.
프로젝트 README에서 생성된 요약
DeepLedger MCP server 정보
DeepLedger는 QuickBooks Online을 Claude, ChatGPT, Grok과 같은 AI agent에 연결하는 AI 스태프 회계사 역할을 합니다. 소규모 사업자, 장부 기입 담당자, 재무 팀이 자연어를 사용하여 회계 업무를 관리할 수 있도록 지원합니다. 이 시스템은 청구서, 송장, 분개장과 같은 거래 기록을 처리하며 미수금, 미지급금 및 은행 피드(bank feeds)도 관리합니다. 또한 재무 보고서를 실행하고, 조정(reconciliation) 작업을 준비하며, 월말 결산 프로세스를 지원할 수 있습니다.
사용자는 Claude Code, Cursor 또는 Grok Build와 같은 호스트를 통해 server와 상호작용합니다. 설정을 위해서는 DeepLedger 계정과 OAuth를 통한 인증된 QuickBooks Online 연결이 필요합니다. 불확실한 데이터에 대해 임의로 판단하는 대신, agent는 사람이 승인할 수 있도록 DeepLedger 포털에 검토 작업을 생성합니다. server는 재무 분석을 위한 qbReports와 기업별 컨텍스트 및 반복 패턴을 유지하기 위한 agentMemory를 포함하여 26개의 전문화된 도구를 제공합니다.
활용 사례
- 1일상적인 거래 기록 자동화AI agent가 기업 신용카드를 사용하여 특정 공급업체에 대한 결제를 기록할 수 있습니다.
- 2재무 분석 및 보고 수행사용자가 손익 계산서를 요청하고 이를 이전 기간과 비교할 수 있습니다.
- 3월말 결산 절차 관리agent가 특정 월의 장부를 마감하는 데 필요한 체크리스트를 실행할 수 있습니다.
- 4은행 피드 분류 처리시스템이 은행 피드에서 기록되지 않은 거래를 가져와 이력을 바탕으로 분류할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
DeepLedger MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 DeepLedger MCP 설치
$ claude mcp add --transport http deepledger-plugin https://mcp.deepledger.ai/mcpCursor에 DeepLedger MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"deepledger-plugin": {
"url": "https://mcp.deepledger.ai/mcp"
}
}
}VS Code에 DeepLedger MCP 설치
.vscode/mcp.json
{
"servers": {
"deepledger-plugin": {
"type": "http",
"url": "https://mcp.deepledger.ai/mcp"
}
}
}VS Code CLI에 DeepLedger MCP 설치
$ code --add-mcp '{"name":"deepledger-plugin","type":"http","url":"https://mcp.deepledger.ai/mcp"}'Codex에 DeepLedger MCP 설치
$ codex mcp add deepledger-plugin --url https://mcp.deepledger.ai/mcpCodex config.toml에 DeepLedger MCP 설치
~/.codex/config.toml
[mcp_servers.deepledger-plugin] url = "https://mcp.deepledger.ai/mcp"
Gemini CLI에 DeepLedger MCP 설치
$ gemini mcp add -s user --transport http deepledger-plugin https://mcp.deepledger.ai/mcpGemini settings.json에 DeepLedger MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"deepledger-plugin": {
"url": "https://mcp.deepledger.ai/mcp",
"type": "http"
}
}
}자동 검사
2026년 11월 15일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능deepledger/deepledger-plugin is public and reachablegithub.com/deepledger/deepledger-plugin ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-14github.com/deepledger/deepledger-plugin ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답HTTPS endpoint answered 401 (sign-in required)통과
README
GitHub에서 보기DeepLedger
AI staff accountant for QuickBooks
DeepLedger connects QuickBooks to Grok, ChatGPT, Claude and other AI agents, allowing businesses to record bills, invoices, payments, deposits, journal entries and other transactions, run financial reports, manage receivables and payables, and track month-end close using natural language.
This repository packages DeepLedger as a plugin for Claude Code, Cursor, Grok Build and Grok Bot. Install it, sign in with your DeepLedger account, and ask for bookkeeping in plain language. The agent works your QuickBooks company the way a staff accountant would: it looks up the payee, checks for duplicates, picks the right transaction type, records it, and hands anything it is not sure about to a human reviewer instead of guessing.
QuickBooks Online stays the ledger of record. DeepLedger holds the QuickBooks connection your company authorized through Intuit's own OAuth flow, so the plugin never sees Intuit credentials. One sign-in reaches every company you can open in the DeepLedger portal.
Who it is for
- Small business owners and founders who keep their own books in QuickBooks Online and want the routine entries, categorization and reports done for them.
- Bookkeepers and CPA firms managing many client companies. One connection switches between companies, every write follows the same protocol, and uncertain items land in a review queue with the agent's reasoning attached.
- Finance teams who want the month-end close, reconciliation prep and management reports drafted for review rather than built from scratch.
What it does
| Area | What the agent does |
|---|---|
| Bank feed | Pulls unrecorded bank and card transactions, categorizes them from the payee's QuickBooks history, records the obvious ones and creates review tasks for the rest |
| Recording | Records payments, bills, invoices, customer payments, deposits, transfers, refunds, credits and journal entries with an ID lookup and a duplicate check before every write |
| Payables and receivables | Enters bills and pays them against outstanding balances, invoices customers and applies their payments, applies credits, reports aging |
| Reconciliation | Matches a bank or card statement to the ledger and prepares the reconciliation workbook and open items |
| Month-end close | Works the close checklist, drafts adjusting entries and the Close Sheet, and hands the package to a reviewer for sign-off |
| Reports and analysis | Runs P&L, balance sheet, aging and custom reports, compares periods and explains what moved |
| Audit preparation | Builds supporting schedules, an evidence index and a missing-document list |
| Memory | Keeps durable per-company knowledge (policies, recurring patterns, context) and applies reviewer corrections going forward |
| Human review | Anything uncertain becomes a task with the agent's reasoning; reviewer decisions are applied verbatim |
How to use it
-
Connect QuickBooks at deepledger.ai: Settings, QuickBooks, Connect. Repeat for each company you manage.
-
Install the plugin in your host (below) and sign in when the browser opens.
-
Ask in plain language. The
bookkeepingskill activates on any accounting request:Which QuickBooks company is active? Process the bank feed. Record: paid $500 to Office Depot for office supplies with the company credit card. Enter the Acme invoice for $2,400, net 30. Reconcile the operating account against the August statement. Generate a P&L for last month and compare it to the prior month. Close the books for June. -
Review what it escalated. Open Tasks in the DeepLedger portal to approve, recategorize or dismiss items the agent was not sure about. Approved tasks are recorded on the next run.
The plugin itself is thin: a connector to DeepLedger's hosted MCP server and one skill. The skill does not carry procedures; it tells the agent which procedure to pull from the server's getGuide tool for each kind of request, so bookkeeping guidance updates on the server without a plugin release. There are no slash commands, agents, hooks or scripts.
Prerequisites
- A DeepLedger account with at least one QuickBooks Online company connected at deepledger.ai (Settings, QuickBooks, Connect)
- One of the hosts below
Install
Marketplace availability depends on each marketplace's review. Until a listing appears, use the local install for that host.
Claude Code
claude plugin marketplace add DeepLedger/deepledger-plugin
claude plugin install deepledger@deepledger-marketplace
Local development: claude --plugin-dir ./deepledger-plugin.
Cursor
Customize, Marketplace, search for DeepLedger, Add. Local install: clone this repository and symlink it into Cursor's local plugins folder, then reload Cursor.
git clone https://github.com/DeepLedger/deepledger-plugin.git
mkdir -p ~/.cursor/plugins/local
ln -s "$(pwd)/deepledger-plugin" ~/.cursor/plugins/local/deepledger
Grok Build
DeepLedger is listed in the xAI plugin marketplace as a remote source pinned to a commit of this repository. Inside Grok Build open the extensions modal with /plugins (or browse with /marketplace), select DeepLedger and install it. Grok Build reads the .grok-plugin/plugin.json manifest, the skill and .mcp.json directly. Enable and trust the plugin so Grok can connect to the bundled MCP server; the first DeepLedger tool call opens the browser sign-in, and /mcps shows the connection.
To test before marketplace approval, install a pinned revision straight from GitHub:
grok plugin install DeepLedger/deepledger-plugin@<full-commit-sha> --trust
Local development: grok --plugin-dir ./deepledger-plugin.
Grok Bot
Settings, Plugins, search for DeepLedger, Add, then complete the sign-in in your browser. Attach the plugin to a task with @ and ask which QuickBooks company is active before requesting accounting work.
Sign-in
On first use the host discovers the server's OAuth 2.1 endpoints (authorization code with PKCE, dynamic client registration) and opens a browser sign-in. Sign in with your DeepLedger account and the connection is authorized. DeepLedger personal API keys (dl_live_...) are also accepted as Bearer tokens for programmatic clients. The transport is Streamable HTTP at https://mcp.deepledger.ai/mcp.
Network access and credentials
The plugin ships no scripts, binaries, hooks or shell commands. Everything it does goes through the hosted MCP server. The one runtime exception is the attachment upload below, where the server returns a shell-quoted curl command for the agent to run. The only network endpoints it reaches are:
| Endpoint | Purpose |
|---|---|
https://mcp.deepledger.ai/mcp |
MCP server (Streamable HTTP). All QuickBooks reads and writes, guides, tasks, memory, documents and reports. |
https://mcp.deepledger.ai/.well-known/oauth-authorization-server, /oauth/register, /oauth/authorize, /oauth/token, /oauth/revoke |
OAuth 2.1 discovery, dynamic client registration, authorization code with PKCE, token refresh and revocation. |
https://deepledger.ai |
Browser sign-in page opened by the host during authorization. |
https://mcp.deepledger.ai/upload-to-qb |
File attachment upload. documents (operation upload) returns a curl command the agent runs to send one user-chosen local file (10 MB limit) to this path with a one-time token; the server forwards it to QuickBooks. It downloads and executes nothing. |
Credentials: a DeepLedger account (OAuth sign-in in the browser, scope quickbooks). The host stores the resulting token; the plugin never sees, stores or transmits Intuit credentials, and it reads no local files, environment variables or secrets. QuickBooks access is scoped to the companies the signed-in user can already open in the DeepLedger portal.
How the skill works
The bookkeeping skill activates on any accounting request. It confirms the active QuickBooks company, then calls the server's getGuide tool with the guide type that matches the request and follows the returned steps, safety checklist and common mistakes:
| Request | getGuide type |
|---|---|
| Record a payment, bill, invoice, customer payment, refund, credit, deposit, transfer or journal entry; categorize bank feed items; AP and AR writes | transaction_recording |
| Close a month, adjusting entries, Close Sheet | month_end_closing |
| Reconcile a statement, explain a reconciliation difference | reconciliation |
| Report comparisons, ratios, trends, budget variances | financial_analysis |
| Audit or review support, evidence index, missing documents | audit_preparation |
| A tool failure the agent cannot resolve from the response | error_recovery (per tool and error code) |
Master data, agent memory, review tasks, documents and custom reports follow their tool descriptions; any QuickBooks write still goes through the transaction_recording protocol.
What the connector provides
The .mcp.json connector points at DeepLedger's official hosted MCP server. It installs no local binary. The server exposes 26 tools; every one operates on the active QuickBooks company and names it in its result.
| Tool | Capability |
|---|---|
qbCompanyProfile |
Show, list or switch the active QuickBooks company |
qbMasterData |
Look up, create or update accounts, vendors, customers, items, classes and tax codes |
qbFetchTransactions |
Fetch transactions for duplicate checks, payee history and outstanding bills or invoices |
qbExpense |
Record or update a purchase paid now (card, ACH, check, cash) |
qbBill |
Record or update a vendor bill to pay later |
qbPayment |
Apply a customer payment to outstanding invoices, or pay outstanding bills applying vendor credits |
qbInvoice |
Create or update a customer invoice |
qbSalesReceipt |
Record a sale paid on the spot, or refund a customer |
qbDeposit |
Record a bank deposit, batching held payments or direct income lines |
qbTransfer |
Move money between the company's own accounts |
qbCredit |
Record a vendor or customer credit |
qbJournalEntry |
Record a balanced journal entry |
qbEstimate |
Create, update or convert an estimate |
qbRecurringTransaction |
Manage recurring transaction templates |
qbProject |
List, create, update and close QuickBooks projects |
qbCustomization |
Manage custom field definitions and transaction dimensions |
qbVoidTransaction |
Void an invoice, sales receipt, refund receipt, payment or bill payment |
qbSendEmail |
Email a sales document to the customer through QuickBooks |
qbReports |
Run profit and loss, balance sheet, aging and other QuickBooks reports |
getGuide |
Load the current bookkeeping procedure or a per-tool error playbook |
tasks |
Review tasks shared between the agent and the human reviewer |
agentMemory |
Read and maintain durable per-company knowledge |
bankFeed |
Fetch unrecorded bank transactions and stamp them once recorded |
documents |
Read documents from DeepLedger storage or QuickBooks attachments, and upload a file to a QuickBooks record |
customReports |
Run saved report definitions by name |
closeRun |
Track the month-end close and its Close Sheet |
Safety model
Every QuickBooks write follows the server's protocol, carried by the transaction_recording guide and the tool descriptions:
- Lookup:
qbMasterDataresolves vendor, customer and account IDs. - Duplicate check:
qbFetchTransactionsverifies no duplicate exists. - Decide: the agent records when the payee, category, tool and amount are obvious from the evidence and it is confident; it creates a review task with specific reasoning only when something is genuinely uncertain. Reviewer decisions on tasks are applied verbatim.
Correctness guards do not yield to confidence: an outstanding bill or invoice dictates the tool, journal entries must balance, voids require a fetch-and-verify first, and there is no batch tool: every transaction is recorded individually so each write passes through the full protocol. Vendor and customer categorization is inferred from QuickBooks history at decision time, not from stored mappings, so a recategorization in QuickBooks takes effect on the next transaction.
Architecture
Plugin (this repo)
skills/bookkeeping/SKILL.md One skill: confirm company, pull the matching getGuide procedure, verify
.grok-plugin/plugin.json Grok Build manifest
.claude-plugin/plugin.json Claude Code manifest
.mcp.json MCP connector for Claude Code and Grok Build
.cursor-plugin/plugin.json Cursor and Grok Bot manifest
mcp.json MCP connector for Cursor
| Streamable HTTP + OAuth 2.1
MCP server (hosted at https://mcp.deepledger.ai/mcp)
26 tools (19 QuickBooks + 7 platform)
getGuide procedures, tasks, memory, documents, bank feed, custom reports, close runs
Connecting QuickBooks
- Log in to deepledger.ai
- Open Settings, QuickBooks
- Click Connect QuickBooks and authorize access
- Once connected, the plugin can read and write to that company
Data handling and support
- Data returned by DeepLedger and QuickBooks is processed in your host session and is subject to the DeepLedger Terms and Privacy Policy.
- Writes go to a live QuickBooks Online company. Review the agent's proposed transaction before approving anything consequential; voids cannot be undone.
- Support: support@deepledger.ai. Plugin issues: GitHub issues.
Version and license
See CHANGELOG.md for release history. MIT License, see LICENSE.
DeepLedger MCP 질문
DeepLedger MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --transport http deepledger-plugin https://mcp.deepledger.ai/mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
DeepLedger MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
DeepLedger는 보안과 인증 정보를 어떻게 처리하나요?
DeepLedger는 Intuit의 OAuth 흐름을 사용하여 연결을 유지하므로, 플러그인이 사용자의 Intuit 인증 정보를 확인하거나 저장하지 않습니다.
AI가 거래 내용에 대해 확신하지 못하면 어떻게 되나요?
불확실한 모든 사항은 agent의 추론 과정과 함께 작업(task)으로 생성되며, 사람이 이를 검토하여 승인, 재분류 또는 폐기할 수 있습니다.
다른 AI 클라이언트와 함께 사용할 수 있나요?
네, Grok, ChatGPT, Claude, Claude Code, Cursor, Grok Bot에서 작동하도록 설계되었습니다.
플러그인을 사용하려면 바이너리를 로컬에 설치해야 하나요?
아니요, 플러그인은 호스팅된 MCP server에 연결하는 가벼운 커넥터이며 로컬에 바이너리를 설치하지 않습니다.