Claude Code Integration with MoLOS
Give your Claude Code agent permanent memory, task management, and project context via MoLOS MCP integration.
Overview
Claude Code is Anthropic's AI-powered coding assistant that runs in your terminal. By connecting it to MoLOS via MCP (Model Context Protocol), your Claude Code agent can:
- Read and create tasks — Build task lists, track bugs, and manage projects
- Search and manage knowledge — Find documentation, create notes, and search your wiki
- Track project progress — Get overviews, check dependencies, and review status
- Log daily activity — End-of-session summaries with mood tracking
- Analyze your patterns — AI-powered insights into your productivity habits
Prerequisites
Before you begin, make sure you have:
| Requirement | How to Check | Minimum Version |
|---|---|---|
| Claude Code installed | claude --version | v2.1+ |
| MoLOS running locally | curl http://localhost:4173 | v1.1.0 |
| Node.js (for stdio transport) | node --version | v18+ |
| An MCP auth key from MoLOS | AI → MCP → Create New Key | — |
Don't have MoLOS running?
See the Quick Start guide to get MoLOS up and running in minutes.
Quick Start (5 minutes)
Step 1: Generate an MCP Auth Key
- Open MoLOS at
http://localhost:4173 - Navigate to AI → MCP
- Click Create New Key
- Name it
"Claude Code"so you know which tool has access - Enable Tasks and Markdown modules (the most useful for coding)
- Click Generate
- Copy the key immediately — you won't see it again
Step 2: Verify MoLOS is Reachable
# Check MoLOS is responding
curl -s http://localhost:4173 | head -n 5
# If using a custom port or remote server
curl -s https://molos.your-domain.com | head -n 5
Step 3: Connect Claude Code to MoLOS
Option A: HTTP Transport (Recommended)
claude mcp add --transport http molos \
--header "Authorization: Bearer YOUR_MCP_AUTH_KEY" \
http://localhost:4173/mcp
Option B: Stdio Transport
claude mcp add --transport stdio \
--env MOLOS_URL=http://localhost:4173 \
--env MOLOS_API_KEY=YOUR_MCP_AUTH_KEY \
molos -- npx -y @molos-app/mcp-client
Step 4: Verify the Connection
# Launch Claude Code
claude
# Inside Claude Code, check MCP status
/mcp
Test it with:
What areas and projects do I have in MoLOS?
What Claude Code Can Do with MoLOS
Task Management
Example 1: Read Active Tasks
You: "Show me my active tasks for the Work area"
Claude Code: [Calls molos_MoLOS-Tasks_get_tasks with area filter]
Here are your active tasks in the Work area:
Q1 Website Redesign (3 tasks):
• PROJ-004 Design homepage mockup [high]
• PROJ-005 Implement navigation [in_progress]
• PROJ-006 Write integration tests [todo]
Example 2: Create Tasks
You: "Create a task in my Q1 Website Redesign project called 'Design homepage mockup' with high priority"
Claude Code: [Creates task via MCP]
Done! Created task:
• Title: Design homepage mockup
• Project: Q1 Website Redesign
• Priority: High
• Key: PROJ-004
Example 3: Update Task Status
You: "Mark the task 'Fix authentication bug' as done"
Claude Code: [Updates task via MCP]
Done! Updated task PROJ-003:
• Status: todo → done
Example 4: Bulk Create Tasks
You: "Create these tasks under 'Work > API Integration':
1. Design API endpoints
2. Implement authentication
3. Write unit tests
4. Update documentation"
Claude Code: [Bulk creates tasks]
Created 4 tasks in API Integration
Example 5: Search Tasks
You: "Find all urgent tasks across all projects"
Claude Code: [Searches via MCP]
Found 2 urgent tasks:
• PROJ-012 Set up OAuth endpoints [API Integration] - due in 2 days
• PROJ-009 Fix production crash [Website Redesign] - due today
Example 6: Get Project Overview
You: "Give me an overview of my 'Q1 Website Redesign' project"
Claude Code: [Reads project details]
Q1 Website Redesign — Status: Active
Task Breakdown:
• Backlog: 2 tasks
• Todo: 3 tasks
• In Progress: 2 tasks
• Done: 5 tasks
Total: 12 tasks | Completion: 42%
Example 7: Create Dependencies
You: "Create dependency: 'Write unit tests' depends on 'Implement authentication'"
Claude Code: [Creates dependency]
Done! PROJ-016 "Write unit tests" is now blocked by PROJ-015 "Implement authentication"
Example 8: Log Daily Progress
You: "Log today's progress: Completed API design, started implementation. Mood: productive"
Claude Code: [Updates daily log]
Done! Daily log updated with notes and mood
Knowledge Management
Example 1: Search Your Knowledge Base
You: "Find my notes about React performance optimization"
Claude Code: [Searches markdown via MCP]
Found 2 matching pages:
1. "React Performance Patterns" (/Notes/Development/)
2. "Frontend Optimization Checklist" (/Projects/Website/)
Example 2: Create Documentation
You: "Create a page called 'API Architecture' with this content..."
Claude Code: [Creates page via MCP]
Done! Created page: API Architecture
Example 3: Create a Quick Note
You: "Add 'Review PR #234' to my quick notes with a red color"
Claude Code: [Creates quick note via MCP]
Done! Created quick note: Review PR #234
Advanced Configuration
Environment Variables
| Variable | Description | Default |
|---|---|---|
MOLOS_URL | MoLOS server URL | http://localhost:4173 |
MOLOS_API_KEY | MCP authentication key | — |
MOLOS_TIMEOUT | Request timeout (ms) | 30000 |
MCP Tools Reference
Tasks Module Tools
| Tool | Description |
|---|---|
get_tasks | Retrieve tasks with filtering |
bulk_create_tasks | Create multiple tasks |
bulk_update_tasks | Update multiple tasks |
get_projects | List all projects |
create_project | Create a new project |
get_areas | List all areas |
get_task_dependencies | View task dependencies |
global_search | Search everything |
get_user_patterns | Analyze your behavior |
get_project_overview | Full project analytics |
update_daily_log | Log notes and mood |
Markdown Module Tools
| Tool | Description |
|---|---|
get_markdown_pages | List documents |
create_markdown_page | Create a new page |
search_markdown_pages | Search documents |
get_quick_notes | List quick notes |
create_quick_note | Create a quick note |
toggle_quick_note_checklist_item | Toggle checklist item |
Troubleshooting
Issue 1: "Claude Code can't connect to MoLOS"
Solutions:
- Verify MoLOS is running:
curl http://localhost:4173 - Check the URL and port
- Check firewall settings
- Verify the MCP endpoint:
curl -H "Authorization: Bearer YOUR_KEY" http://localhost:4173/mcp
Issue 2: "Permission denied"
Solutions:
- Verify your auth key is correct
- Regenerate the key in MoLOS
- Check key permissions for required modules
Issue 3: "Timeout errors"
Solutions:
- Increase timeout:
MCP_TIMEOUT=60000 claude - Check MoLOS performance:
docker stats molos - Reduce concurrent requests
Issue 4: "Claude Code can read but not write"
Solutions:
- Check key permissions (may be read-only)
- Verify module access is enabled
- Ensure
projectIdis specified when creating tasks
Issue 5: "Slow response times"
Solutions:
- Check MoLOS server performance
- Reduce database size (archive old tasks)
- Use HTTP transport for faster connections
Best Practices
- Start with Read Operations — Ask Claude Code to read your data first
- Be Specific with Prompts — Include project names, area names, task details
- Verify Before Bulk Operations — Show what it plans to create before executing
- Use Descriptions for Context — Add descriptions to tasks for future reference
- Log Progress at End of Session — Make it a habit to update daily logs
Comparison: Claude Code with vs without MoLOS
| Capability | Claude Code Only | Claude Code + MoLOS |
|---|---|---|
| Memory | Session-only | Permanent across sessions |
| Task Management | Manual notes | Structured tasks with priorities |
| Project Context | Paste context each session | Automatic project awareness |
| Knowledge Base | Files in workspace only | Searchable across projects |
| Daily Tracking | None | Daily logs with mood |
| Offline | Requires internet | MoLOS works locally |
Resources
- MCP Integration Guide — Generic MCP setup
- Tasks Module — Full tasks reference
- Markdown Module — Full knowledge reference
- Claude Code Documentation — Official Claude Code docs
Last Updated: March 21, 2026 | MoLOS Version: v1.1.0