Skip to main content
Glama
Brain MCP Server

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)

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      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
      D
      maintenance
      A natural language interface for the Brain knowledge management system, enabling conversational interactions, intelligent workflows, and tool suggestions.
      1
      MIT