Browse / Support and bookkeeping
Well
Supplier-invoice retrieval and ledger data behind one official MCP endpoint and CLI; MIT toolkit repo.
Well retrieves supplier invoices from 100,000+ web portals, email, and WhatsApp through a Chrome extension, structures them, and exposes invoices, companies, contacts, transactions, and the accounting ledger as MCP tools at api.wellapp.ai/v1/mcp, with a Claude Code plugin and a Python CLI over the same OAuth backend. The hosted product is in private beta and free to start; the MIT repo holds the CLI, exporters (JSON, CSV, UBL, QuickBooks IIF, Xero CSV), extractor tooling, and the plugin.
- month-end means logging into fifteen supplier portals to download invoices and we want that done for us and queryable from our agent
- we want our agent to list unpaid supplier invoices and fix vendor details from the terminal, then hand a clean export to the accountant
- Private beta; pricing after beta is unpublished
- Retrieval only works in Chrome; the MCP sees what the extension has already captured
- Repo is a toolkit around a closed hosted backend, not the product source
- French-market accents (compte de resultat, Factur-X) in the skills
Last activity Aug 7, 2026. Fit: adaptable 1, operable 2.
Editions
Free (private beta) · Free closed source
- HostedOpen the hosted app
- Install
curl -fsSL https://raw.githubusercontent.com/WellApp-ai/Well/main/cli/well -o /usr/local/bin/well
Toolkit repo · Free open source
- Clone
git clone https://github.com/WellApp-ai/Well
Adaptable: what is yours to change
Make it yours
Light edit5 things to edit
The hosted service is closed; what you adapt is the toolkit: the CLI reads WELL_URL and WELL_CLI_PORT, the Claude Code plugin under plugins/well carries the finance skills you can edit, and new export formats are a Python class registered with @ExporterFactory.register in exporters/. Expect to write a little code for anything beyond pointing the CLI or plugin at your account.
- Env vars
WELL_URLWELL_CLI_PORT- Config files
.claude-plugin/~/.well/credentials.json (generated)- Prompt files
plugins/well/- Accounts you need
- Well account (private beta)Chrome for the retrieval extension
Source
- github.com/WellApp-ai/Well
- MIT license
- Last commit Aug 7, 2026
- 339 stars
Operable: what an agent can drive
Interface
OfficialMCP serverpublished by the builderremote
How an agent can drive an Operable Listing, in five levels: native (built for the agent as the primary interface), official (the Builder ships an agent interface), wrapped (a third party wraps the software's API), config (an agent can only drive it by editing files), gui (screen control only). An interface is official only when it is published by the same organization that ships the software. GUI-level Listings are allowed and sorted last.
- Docs
- api.wellapp.ai/v1/mcp
- Tools
well_get_schemawell_query_recordswell_get_entitywell_add_contact_channelwell_remove_contact_channelwell_update_invoicewell_delete_invoice
Reach
Partial coverage. 5 of 9 jobs reachable through the stated interface.
| Job | Through the interface | Evidence |
|---|---|---|
| Query invoices, companies, people, transactions, and the ledger | Reachable | well_query_records with roots invoices, companies, people, documents, connectors; well_get_schema |
| Fetch one record | Reachable | well_get_entity |
| Update or delete an invoice | Reachable | well_update_invoice, well_delete_invoice |
| Maintain contact channels on companies and people | Reachable | well_add_contact_channel, well_remove_contact_channel |
| Build a P&L, balance sheet, or reconcile transactions | Reachable | README: Claude Code plugin bundles finance skills (compte de resultat, balance sheet, reconcile transactions) on top of the MCP |
| Retrieve invoices from supplier portals | Not reachable | retrieval runs in the Chrome extension with blueprints; no MCP tool triggers it |
| Export to QuickBooks, Xero, UBL | Not reachable | exporters are a Python library in the repo, not an MCP tool |
| Connect Gmail, WhatsApp, Drive, Slack sources | Undetermined | site: 120+ connectors behind one endpoint; connectors root is queryable, setup path not documented |
| Teach a new portal blueprint | Not reachable | Contributor Mode in the extension |
Code stack
- Languages
- PythonTypeScript
- Frameworks
- none
- Package manager
- npm, pip
- Database
- none
- Hosting target
- hosted at api.wellapp.aiChrome Web Store extensionlocal CLI (Python 3.8+, stdlib only)
- Built
- Unknown (recorded, never ranked)
Model stack
- Providers
- any MCP client
- Models
- none
- Keys you need
- none
- Prompts live in
plugins/well (Claude Code skills).claude-plugin/
Skills
Ships a Claude Code plugin marketplace and a library of workflow skills alongside the MCP server.
- Kind
- bundled
- Paths
cursor-rules/skills/*/SKILL.md.claude-plugin/marketplace.json- Install
/plugin marketplace add WellApp-ai/Well
Evidence and confidence
| Field | Where it was seen | Confidence |
|---|---|---|
| formFactor | README MCP Integration: hosted endpoint https://api.wellapp.ai/v1/mcp; cli/README.md: CLI talks to the Well MCP over JSON-RPC | 85% |
| executionModel | site: AI-generated workflow blueprints, self-healing automations; extractor packages in repo | 70% |
| operability | README tool table and docs/mcp/TOOLS.md; plugin marketplace WellApp-ai/Well | 90% |
| effort | cli/README.md configuration table names WELL_URL and WELL_CLI_PORT; README Extending Well shows the exporter class pattern | 75% |
| editions | wellapp.ai: Private beta. Start free. No credit card. | 60% |
| active | gh api: pushed 2026-08-07, 339 stars; Chrome Web Store badge | – |
| reach | 80% |
Open questions
- Post-beta pricing
- Whether connectors can be created through the MCP
- Provenance of the repo code
Sources
- github.com/WellApp-ai/Well sourcing:support-bookkeeping:github
- wellapp.ai/ sourcing:support-bookkeeping:github
- github.com/WellApp-ai/Well/blob/main/docs/mcp/TOOLS.md analysis