Second Brain MCP Server

MCP server to interact with your Second Brain knowledge management system from any MCP-compatible client (Claude Desktop, VS Code, etc.).

Features

• add_log - Add quick notes/log entries with timestamps
• add_document - Create new markdown documents directly
• upload_document - Upload files (.md, .txt, .pdf, .json, .yaml, .csv)
• search - Semantic search across your knowledge base
• chat - Chat with AI using RAG on your documents
• list_logs / get_log - Browse daily logs
• list_documents - Browse vault contents
• get_stats - Knowledge base statistics
• reindex - Trigger vault reindexing

Installation

# Clone or copy this folder to your local machine
cd second-brain-mcp

# Install dependencies
npm install

# Build
npm run build

Configuration

Set environment variables:

# Required: Your Second Brain API URL
export SECOND_BRAIN_API_URL="https://2brain.coer.nl/api"

# Optional: Basic auth credentials (if using access list)
export SECOND_BRAIN_USERNAME="your-username"
export SECOND_BRAIN_PASSWORD="your-password"

Usage with Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on Mac or %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "second-brain": {
      "command": "node",
      "args": ["/path/to/second-brain-mcp/dist/index.js"],
      "env": {
        "SECOND_BRAIN_API_URL": "https://2brain.coer.nl/api",
        "SECOND_BRAIN_USERNAME": "your-username",
        "SECOND_BRAIN_PASSWORD": "your-password"
      }
    }
  }
}

Usage with VS Code (Copilot)

Add to your VS Code settings:

{
  "github.copilot.chat.mcpServers": {
    "second-brain": {
      "command": "node",
      "args": ["/path/to/second-brain-mcp/dist/index.js"],
      "env": {
        "SECOND_BRAIN_API_URL": "https://2brain.coer.nl/api"
      }
    }
  }
}

Example Usage

Once configured, you can use natural language:

• "Add a note about the meeting with John today"
• "Search my knowledge base for homelab documentation"
• "What do I know about Proxmox configuration?"
• "Upload this requirements.txt file to my second brain"
• "Show me my recent logs"

Development

# Run in development mode
npm run dev

# Build for production
npm run build

License

MIT