WorkFullCircle MCP - Universal AI Memory

🧠 Persistent intelligence that works anywhere across all your AI tools

Quick Start

``bash

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/`

Support

- 📖 Documentation
- 🐛 Issues
- 💬 Community

---

WorkFullCircle - Your AI memory, everywhere you need it.