second-brain-mcp

mcp
Security Audit
Fail
Health Pass
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 37 GitHub stars
Code Fail
  • network request — Outbound network request in docs/architecture/draw_flows.py
  • exec() — Shell command execution in scripts/config.mjs
  • process.env — Environment variable access in scripts/config.mjs
  • new Function() — Dynamic code execution via Function constructor in scripts/deploy-your-own.sh
  • rm -rf — Recursive force deletion command in scripts/deploy-your-own.sh
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

My notes in every AI client: a remote MCP server on Cloudflare (Artifacts, Durable Objects, Queues, Workflows, D1, Vectorize, OAuth)

README.md

Second Brain MCP: your Markdown notes in every AI client. A project by Yudi Ganeko

Tests Cloudflare Workers MCP OAuth 2.1 MIT license TypeScript

A remote MCP server that gives every AI client the same Markdown notes: Claude Code on the Mac, Claude on the web and phone, ChatGPT. Search by keyword or by meaning; every change is a Git commit. Deploy your own on Cloudflare.

High-level design: Claude Code and any other client talk MCP to a Worker on Cloudflare, which keeps the notes in Artifacts and embeds them with Workers AI into Vectorize

Deploy your own

Needs a Cloudflare account on the Workers Paid plan, Node 24 and git. No Homebrew or sudo (a second user on a Mac, say)? Install Node with nvm, fnm or the nodejs.org tarball in your home folder, and keep it on the PATH for npx wrangler login too.

A second deployment in the same Cloudflare account (--name with another name) gets its own D1, index, notes, queues, workflow and OAuth store; it shares nothing with the first.

git clone https://github.com/YudiG12/second-brain-mcp && cd second-brain-mcp
npm ci && npm run deploy-your-own

Or ask your AI coding agent:

Clone https://github.com/YudiG12/second-brain-mcp and deploy it for me, following its AGENTS.md.

Every client, Claude Code on the Mac included, reads and writes only through the MCP tools (ADR 014). Optional, a read-only copy of the notes in a folder, to view them in Obsidian:

scripts/secrets.sh hook && npm run mirror -- ~/notes

Don't edit that folder: each run resets it. Run it on a schedule (launchd or cron) to keep it fresh.

How to use

The installer prints your <PUBLIC_URL>. Claude Code:

claude mcp add -s user --transport http <worker-name> <PUBLIC_URL>/mcp

Claude (web, desktop, phone) and ChatGPT: add a custom connector with <PUBLIC_URL>/mcp.

Keyword search sees a change in seconds. Search by meaning is eventually consistent: after a save, edit or move it can take a minute or two to find the new text (and to stop finding the old path).

Then ask:

What did I decide about the Acme proposal?
Save this idea: …
In the plan note, change the deadline to Friday.

Architecture

Overview

Architecture of v2

1. Sign-in

Flow 1-sign-in

2. Write a note

Flow 2-write

3. Index in the background

Flow 3-index

4. Read a note

Flow 4-read

5. Search

Flow 5-search

6. Reconciliation

Flow 6-reconcile

7. A job that keeps failing

Flow 7-failure

Links

Reviews (0)

No results found