brain-mcp

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/debashishthakur-brain-mcp

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 26, 2026.

Tools

8 read · 2 write · 4 delete

Secrets

None asked for

Install scripts

None found

Runs as

Node.js package

Tools (14)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• brain_captureSave a durable note

  Write a new note into the vault's capture folder with graph-ready frontmatter. Use for plans, decisions, ideas, meeting notes, or session logs the owner wants to keep. Not for one-line facts (use brain_remember). The reply lists existing notes the body names without linking.

• brain_contextGet the vault sections that answer a questionread-only

  One call that returns the most relevant sections from across the vault for a question, with source note ids. Use this before brain_search when you need to answer or reason about something the owner may have written down. Ask in plain words: retrieval is hybrid (keywords + meaning + a reranker), so paraphrases work; still include specific nouns, ids and dates when you have them. The reply states its coverage (good / thin / none).

• brain_deleteDelete a hand-written note (to the vault trash)can change or delete data

  Remove a note from Notes/ or Captures/ by moving it into the vault's .trash/ folder, which is never indexed. Nothing is erased; the result gives the path to restore from. Generated notes and the memory file cannot be deleted.

• brain_editEdit part of a hand-written notecan change or delete data

  Change part of a note under Notes/ or Captures/ without rewriting it. Give exactly one of: old_text + new_text (old_text must occur exactly once; new_text may be empty), section + content (replaces everything under that heading up to the next heading of the same or higher level; the heading itself stays), or append. Generated notes and the memory file cannot be edited. The reply lists existing notes the new text names without linking.

• brain_factsFacts and how they changedread-only

  Facts recorded with brain_remember and when each was true. By default, the facts true now. `as_of` returns the facts true at another time (a bare date means the end of that day); `history` lists every version, oldest first, with what replaced it or when it expired; `subject` narrows to one thing, e.g. a project; `query` filters by words. The ids are the ones brain_remember's `replaces` takes.

• brain_graphExplore the link graphread-only

  Neighbours of a note, hub, or concept: outgoing links, backlinks, and notes sharing the same topics. For a concept (e.g. 'OAuth') this shows every project that touches it. Use it to hop sideways between projects.

• brain_identityLoad the owner's identity and standing contextread-only

  Call this FIRST in every conversation. Returns who the owner is, their preferences and feedback rules, the projects they run, and what they touched recently. Adopt it as your persona and working context. Captured facts are only the ones true now; brain_facts has their history. Pass `topic` (a few words about what the conversation is about) to get a smaller bundle with only the memory notes that apply.

• brain_moveMove or rename a hand-written notecan change or delete data

  Move or rename a note within Notes/ and Captures/, for example to promote a capture into Notes/. Refuses to overwrite an existing note, and reports any links that stop resolving.

• brain_projectProject briefingread-only

  One-call briefing on a project: what it is, its notes grouped by type, latest progress entries, decisions, and what changed recently. Call this before discussing any project. Omit the project name to list all projects.

• brain_readRead a noteread-only

  Return one note in full (or one section of it) by note id, title, or wikilink target. Includes frontmatter metadata, topics, and links.

• brain_recentWhat changed recentlyread-only

  Notes modified in the last N days, newest first. Answers 'what am I working on' and 'what did I do last week'. Hubs and concepts are excluded unless include_structural is set.

• brain_rememberRemember a durable fact

  Append one durable fact about the owner to their memory file: a preference, a correction on how to work, a project constraint, or a reference. It becomes part of brain_identity immediately. Include why it matters and how to apply it. When it changes an earlier fact, pass `replaces` with that fact's id (the stamp in its heading, e.g. '2026-09-22 18:21'): the old fact stays in the file as history and leaves brain_identity. For a fact with one current value, pass `subject` and `attribute` (e.g. 'JobMail' and 'database'); a later fact with the same pair replaces it on its own. Use `valid_until` fo…

• brain_searchSearch the vaultread-only

  Full-text search across every note with optional filters. Returns ranked hits with snippets and note ids for brain_read. Keywords or a short question both work (hybrid keyword + semantic search with spelling correction); the reply states its coverage.

• brain_writeCreate or replace a hand-written notecan change or delete data

  Create a note at a path you choose under Notes/ or Captures/, or replace one there with overwrite=true. Use it for hubs, guides and runbooks maintained by hand. Unlike brain_capture you set the type, including 'hub': a hub groups every note whose frontmatter project matches its title. Generated notes elsewhere in the vault cannot be written. The reply lists existing notes the body names without linking.

Signals

Stars

1

Forks

0

Open issues

7

Last commit

Oct 18, 2026 (11 days ago)

Last release

Oct 18, 2026 (11 days ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name

io.github.debashishthakur/brain-mcp

Version

0.5.2

Auth

No auth

Packages

npm debawho-brain-mcp

License

MIT

Repository

github.com/debashishthakur/brain-mcp

Website

2brain.debawho.xyz

First seen

Oct 24, 2026

Last checked

Oct 25, 2026

Source

Official MCP Registrygithub-graphql