Skip to main content
Glama
greghughespdx

Brain MCP Server

Brain MCP Server

MCP server exposing Brain service operations as tools via FastMCP.

Tools

  • save_to_brain - Save thought with full metadata

  • quick_capture - Quick capture with auto-classification

  • search_brain - Search thoughts by text query

  • list_recent - List recent entries with filters

  • get_entry - Fetch specific entry by ID

Related MCP server: TheBrain MCP Server

Transports

  • stdio - Local development (default)

  • SSE - Remote access via HTTP (with OAuth 2.0 support)

For OAuth configuration and remote access setup, see OAUTH_SETUP.md.

Local Development

# Install dependencies
pip install -r requirements.txt

# Run with stdio transport
python brain_mcp_server.py

# Run with SSE transport
MCP_PORT=8084 MCP_TRANSPORT=sse python brain_mcp_server.py

# Test with MCP inspector
mcp dev brain_mcp_server.py

Docker Deployment

docker compose up -d

Builds from GitHub and runs with SSE transport on port 8084.

Environment Variables

Variable

Default

Description

BRAIN_API_BASE

https://n8n.gregslab.org/webhook

n8n Brain webhooks URL

BRAIN_API_TIMEOUT

30.0

API timeout in seconds

MCP_TRANSPORT

stdio

Transport mode (stdio/sse)

MCP_PORT

8084

SSE server port

MCP_HOST

0.0.0.0

SSE server host

BASE_URL

http://{MCP_HOST}:{MCP_PORT}

Base URL for OAuth metadata

OAUTH_ENABLED

false

Enable OAuth (advisory flag)

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    F
    maintenance
    Enables AI assistants to interact with TheBrain's knowledge management system for creating, searching, and organizing thoughts, notes, and attachments using natural language. It provides comprehensive tools for managing hierarchical thought structures, link relationships, and file attachments through TheBrain's API.
    26
    16
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables AI assistants to interact with TheBrain's knowledge management system through natural language for managing thoughts, notes, and attachments. It supports core features like full-text search, relationship mapping, and file uploads to streamline digital brain organization.
    3
    Apache 2.0
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables semantic search across your local AI conversation history (ChatGPT, Claude, etc.) and provides tools to retrieve context, capture thoughts, and get profile summaries.
    65
    AGPL 3.0