WorkFullCircle MCP - Universal AI memory that works anywhere
npm install workfullcircle-mcpbash
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:
$3
`bash
WorkFullCircle API Configuration
WFC_API_URL=https://workfullcircle.com # Streamable HTTP endpoint
WFC_API_KEY=uam_your_api_key_here # Your API key
`
$3
`bash
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
$3
`bash
npx @workfullcircle/mcp install --token uam_your_token
`
- Automatically detects and configures: Claude Desktop, Cursor, Windsurf, VS Code
- No manual config file editing required
$3
Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):
`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):
`json
{
"mcpServers": {
"workfullcircle": {
"command": "npx",
"args": ["-y", "workfullcircle-remote", "https://workfullcircle.com/sse", "--header", "Authorization: Bearer uam_your_token"]
}
}
}
`
$3
For direct API connections without SSE:
`json
{
"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:
`bash
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:
`bash
.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:
`bash
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/`