Cloudflare setup guide

Deploy your own AI-powered memory backend.

Overview

SecondBrain Pro can connect to your own Cloudflare Workers backend, giving you full control over your data with global edge performance (<50ms latency). The backend is powered by shodh-cloudflare, an open-source distributed AI memory system.

Clients

SecondBrain iOS, Apple Watch, Claude Desktop, Cursor / VS Code

Cloudflare Workers

Receives requests over the REST API and MCP.

Storage and AI

D1 database, Vectorize index, Workers AI

Prerequisites

Premium is required for the custom backend and MCP integration. Local capture and free iCloud sync work without this setup. Connected MCP clients can access backend memories under their own provider policies. Read the data handling details.

A Cloudflare account (provider plan limits and usage charges apply)
A supported Node.js LTS release installed
Wrangler CLI: npm install -g wrangler
Git installed

Step-by-step setup

Step 1: Clone the repository

git clone https://github.com/doobidoo/shodh-cloudflare.git
cd shodh-cloudflare

Step 2: Create the D1 database

wrangler d1 create shodh-memory

Note the database_id from the output. You need it in the next step.

Step 3: Create the Vectorize index

wrangler vectorize create shodh-vectors --dimensions=384 --metric=cosine

Step 4: Configure wrangler.toml

cp worker/wrangler.toml.example worker/wrangler.toml

Edit worker/wrangler.toml and replace the database_id with your value from step 2.

Step 5: Initialize the database schema

cd worker
wrangler d1 execute shodh-memory --file=../schema.sql --remote

Step 6: Set your API key

wrangler secret put API_KEY

Choose a strong API key. You enter the same key in the SecondBrain iOS app.

Step 7: Deploy

npm install
npm run deploy

Your worker is deployed to https://shodh-memory.YOUR-SUBDOMAIN.workers.dev

Step 8: Verify

curl https://shodh-memory.YOUR-SUBDOMAIN.workers.dev/

You should see: {"message":"SHODH Memory API is running"}

Connect the SecondBrain iOS app

Open SecondBrain Pro → Profile tab
Tap Not Configured under API Configuration
Enter your API Key (from step 6)
Enter your Base URL: https://shodh-memory.YOUR-SUBDOMAIN.workers.dev
Tap Save & Validate

Your API key is stored in the iOS Keychain and never leaves your device unencrypted.

What is included

AI-powered features

Smart classification: memories are auto-categorized (observation, decision, learning, etc.)
Auto-tagging: 2 to 4 contextual tags generated per memory
Voice correction: AI fixes dictation errors from Siri and Watch input
Semantic search: find memories by meaning, not just keywords
AI summarization: ask questions and get summaries across memories

Temporal queries

Search with natural language time expressions:

"What did I learn last week?"
"Show me decisions from 3 days ago"
"Memories from yesterday about the project"

Emotional metadata

Each memory can track emotional context with valence, arousal and emotion labels. This helps you understand patterns in how you feel about different topics.

Costs

Cloudflare usage is separate from the one-time Premium app purchase. Check current Workers, D1, Vectorize and Workers AI plans and limits before deploying. Free allowances do not guarantee zero cost for your workload.

Next steps

Set up MCP integration: connect your memories to Claude Code, Cursor or VS Code
See the app screenshots
Backend repository: full source code, documentation and troubleshooting