second-brain

Second Brain — AI Memory & Productivity System

AI-powered personal memory layer for Claude Code and Claude Desktop. Persistent cloud memory, live integrations (Gmail, GitHub, Asana, Google Calendar), 49 skills, 4 agents, and 22 MCP prompts.

Architecture

┌──────────────────────────────────────────────────────────────┐
│                    CLOUD (for everyone)                       │
│                                                               │
│  MCP Server: https://second-brain-cloud-app.azurewebsites.net│
│  Dashboard:  (same URL, port +1)                              │
│  Database:   NeonDB (Postgres + pgvector)                     │
│  Reflection: AWS Bedrock (Claude Haiku)                       │
│  Repo:       github.com/viditparashar96/second-brain-cloud    │
│                                                               │
│  22 MCP tools │ 22 MCP prompts │ 7 MCP resources              │
│  Per-user vault │ Hybrid RAG search │ Auto-memory              │
└──────────────────────────┬───────────────────────────────────┘
                           │
              MCP over HTTPS (?key=sb_xxx)
                           │
          ┌────────────────┼────────────────┐
          │                │                │
   Claude Desktop    Claude Code      claude.ai
   (HR, Sales, Ops)  + This Plugin    (web users)
                     (Engineers)

Cloud MCP Server

The cloud MCP server provides shared memory, integrations, and prompts for all users. No local install needed — just connect with your unique URL.

Production URL:

https://second-brain-cloud-app.azurewebsites.net/mcp?key=YOUR_API_KEY

Cloud Repo: github.com/viditparashar96/second-brain-cloud (private)

What the Cloud Provides

Feature	Count	Details
MCP Tools	22	Vault CRUD, search, logging, Gmail, GitHub, Asana, GCal, status
MCP Prompts	22	Core, HR, Sales, Product, Ops, Org workflows
MCP Resources	7	SOUL, USER, ORG, PRODUCTS, MEMORY, HABITS, Today's log
Search	Hybrid RAG	pgvector (semantic) + PostgreSQL FTS (keyword), 70/30 merge
Memory	Auto	SOUL.md rules make Claude log everything important
Reflection	Daily	Bedrock extracts decisions/actions → MEMORY.md

Connect: Claude Code (Engineers)

Step 1: Install Plugin (for skills + agents)

# Add marketplace
/plugin marketplace add https://github.com/viditparashar96/second-brain-claude

# Install
/plugin install second-brain@blackngreen-tools

Step 2: Connect Cloud Memory (global — works in every project)

claude mcp add second-brain-cloud "https://second-brain-cloud-app.azurewebsites.net/mcp?key=YOUR_API_KEY" -t http -s user

Get your API key from the admin dashboard.

Step 3: Use It

# Skills (from plugin)
/eng-plan build GPS tracking for School Cab
/eng-code-review
/meeting-notes

# Cloud memory (from MCP — works automatically)
"search my memory for Nexiva"
"log a note: decided to use pgvector"
"what's on my calendar today?"
"run daily reflection"

Skills call cloud MCP tools automatically — all decisions, meetings, and outcomes are logged to your cloud vault.

Connect: Claude Desktop (HR, Sales, Ops, Product)

Step 1: Admin Creates User

Admin creates user on the dashboard or via API. Each user gets a unique API key.

Step 2: Open the Config File

macOS — run in Terminal:

open ~/Library/Application\ Support/Claude/claude_desktop_config.json

Windows — run in Command Prompt:

notepad %APPDATA%\Claude\claude_desktop_config.json

Linux — run in terminal:

nano ~/.config/Claude/claude_desktop_config.json

Step 3: Add the MCP Server

Copy-paste this into the mcpServers section (replace YOUR_API_KEY with your key):

{
  "mcpServers": {
    "second-brain": {
      "command": "npx",
      "args": ["mcp-remote", "https://second-brain-cloud-app.azurewebsites.net/mcp?key=YOUR_API_KEY"]
    }
  }
}

Note: If you already have other MCP servers configured, just add the "second-brain": {...} block inside the existing mcpServers object.

Step 4: Restart Claude Desktop

macOS: Cmd+Q → reopen Claude Desktop Windows: Close → reopen Claude Desktop

You should see second-brain with a green badge in Settings > MCP Servers.

Step 3: Use It

• Click "+" button → see 22 prompts (Status Check, Draft Email, Deal Prep, Meeting Notes, etc.)
• Just chat — Claude auto-uses tools (search memory, check tasks, draft emails)
• Memory builds automatically — Claude logs decisions, creates vault files, tracks projects

Connect: claude.ai (Web)

Add as a Custom Connector in Settings → Connectors:

URL: https://second-brain-cloud-app.azurewebsites.net/mcp?key=YOUR_API_KEY

Plugin Skills (49)

Available in Claude Code via /skill-name: