BrainDog

dog.brainPublished by brain.dogOfficial publisherv0.1.0Updated Nov 5, 2026

One place for your projects, decisions and money, read and written by every agent you use.

VerifiedStreamable HTTPWeb executableProductivity & WorkflowFinanceKnowledge & Memory

Overview

AI-generated overview

BrainDog is a hosted record of projects, decisions and money that connected AI agents read before starting work and write their results into.

What you can do
  • Read and update projects and tasks, including where each project stands and its next step
  • Record what an agent did, with its name on each change and an undo
  • Answer agents' open questions from a single list, keeping each answer and its reason
  • Work with money and people: accounts, bills, invoices, budgets, clients and contacts, with CSV and vCard imports
  • Store API keys that agents can use without seeing them, and attach PDFs, images, documents and HTML pages to projects or tasks
  • Manage team roles and read-only share links, and ask questions in plain words that are answered from the record's own numbers
When to use it
Useful when several agents work on the same projects and need shared, durable context instead of repeating it each session, and when that context includes budgets, clients and credentials that should stay in one governed place.
Requirements
A remote MCP endpoint at app.brain.dog, reached by address in any MCP client; OAuth sign-in is required, and the first connection opens BrainDog in a browser to pick the record and the agent's permissions. Hosted sign-up is invitation-only. The optional command line needs Node 24.13 or later, and self-hosting needs Docker or Node with pnpm.
Before you install
The record holds money data, client and contact details, and API keys, so an agent's granted scope matters. Money, keys, sharing and deletes wait for approval by default, but you can let your own agents skip that; reading a key, sharing the record and deleting it always stay with you. Plugins can add tools, commands and scripts, including ones installed from GitHub repos, so review what a plugin can do before installing it.

Installation

In SourceWeft

  1. Open BrainDog in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/dog.brain%2Fbraindog/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "braindog": {
      "type": "http",
      "url": "https://app.brain.dog/mcp"
    }
  }
}

README

[BrainDog: Your agents keep track. You make the calls.]

Your agents keep track. You make the calls.

One place for your projects, decisions and money. Every agent reads it before it starts and writes down what it did. Money, keys and deletes wait for your yes.

BrainDog is open source. Use it hosted at brain.dog, or run it on your own machine.

Website · Docs · Connect your agents · Run it yourself · Plugins

[BrainDog's Today page: a question waiting on you, the agents working now, a late invoice, cash ahead, what is due soon and this week's tasks]

Today on the sample record. Every name and figure in it is made up.

What it does

  • Work. Projects and tasks. Each project shows where it stands and the next step.
  • Agents. Each agent you connect starts by reading where the project stands and writes the next step down when it ends. Every agent signs in with your yes and puts its name on what it writes. You see who is working on what.
  • Needs you. Questions from agents wait in one list, each with what would happen and why. Your answer is kept, with its reason.
  • Money. Accounts, bills, invoices, budgets and how long the cash lasts, in more than one currency. Import a bank statement as a CSV and each line is filed.
  • People. Clients, contacts, and who owes whom. Import them from a CSV or a vCard.
  • Keys. Keep API keys in the record. Agents use them without ever seeing them.
  • Attachments. Put PDFs, pictures, documents and HTML pages on a project or a task. Agents read them.
  • Team. Invite people with one of five roles: Owner, Can decide, Can edit, Can add or Can view. Their agents get the same access, no more. Share one page with a read-only link, with or without money.
  • Slash. Press / or ⌘J (Ctrl J on Windows) and ask BrainDog in plain words. It answers from your own numbers, and a change it makes comes with an undo.
  • Plugins. Everything else, from bank feeds to a landlord's rent book. See Plugins.

It works in any browser. The iPhone app is in testing on TestFlight, and a Mac app is built from the same project. Neither is in the App Store yet.

What always holds

  • Every change has a name on it and an undo.
  • History is never rewritten. You can ask what the record said last Tuesday.
  • Money, keys, sharing and deletes wait for your yes. You can let your own agents skip that, but reading a key, giving the record away and deleting it stay yours.
  • You can export everything as one file at any time.

Connect your agents

By address. Any client that takes an MCP server address can use this one:

text
https://app.brain.dog/mcp

In Claude that is Settings, Connectors, Add custom connector. The first time, the client opens BrainDog in your browser. Pick the record and what the agent may do, then press Allow.

With the command line. For Claude Code and other agents on your machine. It needs Node 24.13 or later.

sh
curl -fsSL https://brain.dog/cli/install.sh | sh     # macOS and Linuxirm https://brain.dog/cli/install.ps1 | iex          # Windows, in PowerShellbraindog setup https://app.brain.dog/<your record>

setup signs the machine in (you approve six digits in the app), adds the Claude Code hooks, registers the MCP server and places the Agent Skill. apps/cli/README.md has the rest, and brain.dog/docs/agents/connect covers every client.

As a Claude Code plugin. This adds the MCP server, the session hooks and the skill in one step:

text
/plugin marketplace add actuallyhoss/BrainDog/plugin install braindog@braindog

Attachments

Put a file on a project, a task or any row.

  • A PDF opens in the browser's own viewer.
  • An HTML page, such as an artifact an agent made, is drawn in a sandbox. It can load its chart and style libraries, and it can't reach the app, your sign-in or anything else.
  • Agents read every file as text.
  • A file can be up to 25 MB. Every add, rename and removal is in the history, with who and when.

From the command line:

sh
braindog attach brief.pdf dashboard.html --to "Fix the login"braindog attach --list --to "Fix the login"

Plugins and starters

Projects, Work, People and Agents are built in. Everything else is a plugin, installed from the app's Plugins page: Money and its parts (investments, property, insurance, debts, goals, trips, zakat), Stripe, Mercury, Gmail, Calendar, Sentry, standups, project briefs and more. A starter is a set of plugins and example rows for one kind of work, such as a photographer, a landlord or a retainer business.

Where they come from.

  • The plugin store. Nothing from outside is listed until a person at BrainDog has reviewed it.
  • Any GitHub repo. The install is pinned to a commit, and updates come from that repo.
  • Your own BrainDog. Ask an agent for something BrainDog doesn't do. It writes the plugin, checks it, and asks you before it installs.

What they can do. Lists, pages, figures and rules. Tools your agents can call, commands, and actions on a row. Views they draw themselves. Scripts that notify you, ask a model or keep their own data. You see each of these before you install, and a plugin gets only what you approved. Scripts run in a sandbox and reach only the hosts the file names.

If one goes wrong. BrainDog can switch off a bad version of a store plugin wherever it is installed, and tells you why. Its rows stay.

Make one. A plugin is one readable file, so you can read and diff it before it is applied. The command line still calls it addon.

sh
braindog addon new plant-care                    # a folder with the file, a test and a READMEbraindog addon dev plant-care                    # a scratch BrainDog that installs each savebraindog addon check plant-carebraindog addon publish plant-care --github       # or --kennel, to send it to the store for review

The bundled ones live in packs/ (the folder keeps its old name), and packs/README.md shows how to write one.

Two ways to run it

Hosted, at app.brain.dog. Each record is its own database on Cloudflare. Keys are sealed, and a sealed copy is made every night. Sign-up is by invitation for now: ask for one at brain.dog.

Run it yourself. Free. One container, one volume, no account with us.

Run it yourself

sh
git clone https://github.com/actuallyhoss/BrainDog braindogcd braindogcp selfhost.env.example .env      # set BRAINDOG_OWNER (your email) and BRAINDOG_SERVER_KEY (the server key)docker compose up -d --builddocker compose logs braindog      # once started, it ends with the addressdocker compose exec braindog cat /data/claim-link      # a one-time link: open it and add a passkey

Without Docker you need Node 24.13 or later and pnpm. This serves http://localhost:8080 to your own machine, where nobody signs in:

sh
pnpm installpnpm --filter @braindog/web buildexport BRAINDOG_DATA=$HOME/braindog-datanode apps/selfhost/src/main.ts init <record name> --owner <your email>node apps/selfhost/src/main.ts

Mail, a model for Slash and a public address are optional and off until you set them. apps/selfhost/README.md covers connecting agents, backups, restores and upgrades. docs/49-SPEC-SELFHOST.md lists every setting the server reads.

How it's built

TypeScript throughout, on Node 24, with no build step for most packages.

  • packages/kernel is the write path: one way in, an append-only ledger, types, filters, figures and rules.
  • packages/record puts the kernel, the declarations and plugins together into one record over SQLite.
  • packages/mcp serves the record to agents.
  • packages/script is the sandbox plugin scripts run in.
  • packages/render is the block dialect and its renderers, published on its own as braindog-render.
  • apps/web is the app, in SvelteKit. Both hosts serve the same build.
  • apps/worker is the hosted version on Cloudflare Workers: one Durable Object, with its own SQLite, per record. It also runs the plugin store.
  • apps/selfhost is the same record on one Node process over node:sqlite, and the container.
  • apps/cli is the braindog command line, and apps/site is brain.dog.
  • apps/apple is the iPhone and Mac app. apps/desktop is the older desktop shell, kept for Windows and Linux.
  • tools/gates holds the source checks every change passes.

The design is written down first, in docs/. docs/00-README.md is the index, and docs/01-ARCHITECTURE.md is the place to start.

Docs

  • brain.dog/docs: using BrainDog, connecting agents, the HTTP API and writing plugins.
  • docs/: the numbered design and specification documents.
  • DEPLOYMENT.md: how the hosted version is deployed.

Security

Please don't open a public issue for a vulnerability. SECURITY.md says how to report one privately. docs/12-SECURITY.md is the security model in full.

Contributing

Issues and pull requests are welcome. Read CONTRIBUTING.md first. It covers the build, the tests, the gates and the house style, and a pull request that skips it is usually sent back. Everyone here follows the code of conduct.

Licence

BrainDog is open source under the Apache License 2.0 (LICENSE). The exception is packages/render, under the MIT License (packages/render/LICENSE), so the block dialect can be embedded anywhere. LICENSING.md explains the split.

The software is provided as is, without warranty of any kind, express or implied. See the licence texts for the full terms.

Source: README.md at commit 0b9f702

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v0.1.0LatestNov 5, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Brain integrations

Codebase Brain

Published by GitHub account Nomannazir

Indexes a local or public git codebase so an assistant can search it, trace git history, check change impact and find stale docs, all with path:line citations.

STDIODesktop only
Developer ToolsNot validated yetNov 7, 2026

Personal Brain

Published by GitHub account zhang-liz

Gives an AI assistant memory of your professional network, stored as a graph in FalkorDB, so it can look up contacts, find people by topic, and save who you…

STDIODesktop only
Databases3 toolsNov 6, 2026

Second Brain

Published by GitHub account ara-5

Shared Graph-RAG memory for AI agents: markdown vault, wikilink recall, tasks, messaging.

STDIODesktop only
AI & ML12 toolsNov 7, 2026

Make0 Brain

Published by GitHub account make0-official

Local, offline MCP memory server that gives every connected AI agent one shared, versioned store of facts and short notes to search, read and update.

STDIODesktop only
AI & ML7 toolsNov 3, 2026

Thinking Brain School — Teaching MCP

Published by GitHub account ariaxhan

Remote MCP endpoint that lets an AI assistant run guided practice with Thinking Brain School lessons a family has unlocked.

Streamable HTTPWeb executableAuth
Credential requiredOct 26, 2026