Which integrations are available for this server?

Provides tools to interact with a Brain service via n8n webhooks, enabling capabilities like saving, searching, and managing thoughts or entries with full metadata.

How do I use Brain MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Brain MCP Server quick capture: just had an idea for a new project structure" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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

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)