WorkFullCircle MCP - Universal AI Memory

🧠 Persistent intelligence that works anywhere across all your AI tools

Quick Start

# Install and configure automatically
npx workfullcircle-mcp install --token uam_your_token_here

# Or use the Streamable HTTP bridge directly
npx workfullcircle-remote https://your-server.com --header "Authorization: Bearer uam_your_token"

Environment Variables

Configure your MCP server with these environment variables:

Required Variables

# WorkFullCircle API Configuration
WFC_API_URL=https://workfullcircle.com          # Streamable HTTP endpoint
WFC_API_KEY=uam_your_api_key_here                # Your API key

Optional Variables

# Testing
TEST_API_URL=http://localhost:9001/api               # Local testing API
TEST_API_KEY=uam_test_key                            # Local testing key

# Server Configuration (for self-hosting)
HOST=0.0.0.0                                         # Server host
PORT=9001                                            # Server port
NODE_ENV=development                                 # Environment

Installation Methods

Method 1: Auto-Install (Recommended)

npx @workfullcircle/mcp install --token uam_your_token

• Automatically detects and configures: Claude Desktop, Cursor, Windsurf, VS Code
• No manual config file editing required

Method 2: Manual Configuration

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "workfullcircle": {
      "command": "npx",
      "args": ["-y", "workfullcircle-remote", "https://workfullcircle.com/sse", "--header", "Authorization: Bearer uam_your_token"]
    }
  }
}

Cursor/Windsurf (~/.cursor/mcp.json or ~/.windsurf/mcp.json):

{
  "mcpServers": {
    "workfullcircle": {
      "command": "npx",
      "args": ["-y", "workfullcircle-remote", "https://workfullcircle.com/sse", "--header", "Authorization: Bearer uam_your_token"]
    }
  }
}

Method 3: Local API Connection

For direct API connections without SSE:

{
  "mcpServers": {
    "workfullcircle": {
      "command": "npx",
      "args": ["-y", "workfullcircle-mcp-local"],
      "env": {
        "WFC_API_URL": "https://workfullcircle.com/api",
        "WFC_API_KEY": "uam_your_token"
      }
    }
  }
}

Platform Support

✅ Claude Desktop - Full SSE support
✅ Cursor - Full SSE support
✅ Windsurf - Full SSE support
✅ VS Code - Via global MCP extension
✅ LangChain - Via stdio interface
✅ Custom integrations - Standard MCP protocol

Available Tools

• save_memory - Store important information
• get_memory - Search and retrieve memories
• capture_cognition - Auto-capture conversations
• delete_memory - Remove stored memories
• update_memory - Modify existing memories
• list_all_memories - Browse all stored memories

Self-Hosting

Set up your own WorkFullCircle server:

1. Clone and setup:

git clone https://github.com/workfullcircle/universal-ai-memory-mcp
cd universal-ai-memory-mcp
cp .env.example .env
# Edit .env with your configuration
npm install
npm start

2. Configure environment:

# .env file
SUPABASE_URL=your_supabase_url
SUPABASE_SERVICE_ROLE_KEY=your_service_role_key
OPENAI_API_KEY=your_openai_key
HOST=0.0.0.0
PORT=9001

3. Connect clients:

npx workfullcircle-mcp install --token uam_your_token --server-url http://localhost:9001

Architecture

• workfullcircle-mcp - Main installer CLI
• workfullcircle-remote - SSE proxy for remote servers
• workfullcircle-mcp-local - Direct API client

Troubleshooting

Connection Issues:

• Verify WFC_API_KEY is correct and starts with uam_
• Check WFC_API_URL is accessible
• Ensure firewall allows connections to workfullcircle.com

Configuration Issues:

• Run npx workfullcircle-mcp install to auto-fix configs
• Check JSON syntax in manual config files
• Restart IDE after configuration changes

Platform-Specific:

• Windows: Configs in %APPDATA%\Claude\ and %USERPROFILE%\.cursor\
• macOS: Configs in ~/Library/Application Support/ and ~/.cursor/
• Linux: Configs in ~/.config/ and ~/.cursor/

Support

• 📖 Documentation
• 🐛 Issues
• 💬 Community

WorkFullCircle - Your AI memory, everywhere you need it.