All Projects

SJForge Tasks MCP Server

Production

Model Context Protocol server bridging Claude Code with personal infrastructure

Problem

Claude Code operates in isolation from personal productivity systems. Task management, project tracking, and knowledge retrieval require constant context switching.

Solution

An MCP server exposing 14 tools over stdio transport, enabling Claude Code to directly create/update tasks, log coding sessions, track projects across 7 domains, and semantically search a personal knowledge base — all without leaving the terminal.

Key Features

  • 14 tools across 4 domains (tasks, projects, sessions, knowledge)
  • Task CRUD with 7 life domains and priority levels
  • Session logging with project/commit tracking and 30-day stats
  • Semantic search via OpenAI embeddings for knowledge base
  • Document creation with automatic embedding generation
  • Fuzzy matching for natural-language task and project lookups

Tech Stack

TypeScriptMCP SDKSupabaseOpenAI EmbeddingsNode.js

Architecture

MCP server using stdio transport with @modelcontextprotocol/sdk. Supabase service role client for direct database access. Modular tool structure with separate files per domain. OpenAI text-embedding-3-small for semantic search. Configured in ~/.mcp.json and loaded by Claude Code at startup.

Screenshots

Screenshots coming soon

Metrics

14
MCP Tools
4
Domains
MCP/stdio
Protocol

My Role

Sole developer. Designed the tool interface, implemented Supabase integration with service role auth, and built semantic search with OpenAI embeddings.