Metadata-Version: 2.4
Name: countbean-mcp
Version: 0.3.1
Summary: MCP server for Beancount plain-text accounting: double-entry transactions written by an AI agent, validated with bean-check and committed to git.
Author: Tim Derzhavets
License: MIT
Project-URL: Homepage, https://countbean.com
Project-URL: Source, https://github.com/CPUtester5465/countbean-plugin
Project-URL: Roadmap, https://countbean.com/roadmap
Keywords: mcp,model-context-protocol,beancount,plain-text-accounting,accounting,bookkeeping,double-entry,ledger,claude
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business :: Financial :: Accounting
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp<2,>=1.2
Requires-Dist: beancount<4,>=3.0.0
Requires-Dist: beanquery>=0.1.0
Requires-Dist: openpyxl>=3.1.0
Dynamic: license-file

# Countbean plugin for Claude Code

Hosted plain-text accounting in Claude Code: a git-backed [Beancount](https://beancount.github.io/)
ledger, AI ingestion of statements and receipts into validated double-entry, and HTML/Excel reports.

## Install

```
/plugin marketplace add https://github.com/CPUtester5465/countbean-plugin.git
/plugin install countbean@countbean
```

Use the full HTTPS URL, not the `CPUtester5465/countbean-plugin` shorthand — the shorthand resolves
to `git@github.com`, which needs an SSH key *and* GitHub's host key already in your `known_hosts`.

Then connect it to your book — one line, from the book's page at
[app.countbean.com](https://app.countbean.com) under **Connect Claude**:

```
/countbean:connect cbk_… bok_…
```

Full documentation is in [`plugin/README.md`](plugin/README.md).

---

## This repository is published, not authored

The source of truth is the `plugin/` directory of the Countbean monorepo. This repo is a mirror,
pushed by CI on every change.

**Pull requests here cannot be merged** — they would be overwritten by the next publish. The
mirror exists so that installing the plugin does not require access to the private monorepo,
and so `plugin/mcp/countbean_mcp/ledger.py` can keep being byte-compared against its
`ledger_core` original by tests that need both in one tree.
