taskflow-agent 0.2.0

Lightweight project and task manager with MCP tools for Claude Code

taskflow-agent

Lightweight project and task manager with MCP tools for Claude Code.

SQLite backend, 20 MCP tools, web UI with embedded AI chat, and a FastAPI REST API. Built as a self-hosted Asana replacement optimized for AI-assisted workflows.

Features

• 20 MCP tools — full project/task CRUD, search, views, service lifecycle management
• Web UI — dark-theme SPA with project boards, task details, inline editing
• AI chat — embedded Claude chat with workspace awareness and tool access
• FTS search — full-text search across task names and notes
• Asana import — bulk import from Asana CSV exports
• Service management — start/stop the web server via MCP tools or Makefile

Quick Start

pip install -e ".[web]"

# Start the MCP server (for Claude Code)
taskflow

# Start the web UI
make serve          # foreground
taskflow-web        # via CLI

MCP Tools

Projects

Tool	Description
tf_list_projects	List active projects with task counts
tf_get_project	Get project with sections and tasks
tf_create_project	Create a new project
tf_update_project	Update project fields
tf_archive_project	Archive a project

Sections

Tool	Description
tf_create_section	Add a section to a project
tf_update_section	Update section fields
tf_move_section	Reorder a section

Tasks

Tool	Description
tf_list_tasks	List tasks with filters
tf_get_task	Get task details with subtasks and tags
tf_create_task	Create a task
tf_update_task	Update task fields
tf_complete_task	Mark task completed
tf_reopen_task	Reopen a completed task
tf_move_task	Move task between projects/sections
tf_delete_task	Delete a task

Search & Views

Tool	Description
tf_search	Full-text search across tasks
tf_due_soon	Tasks due within N days
tf_overdue	All overdue tasks

Service Lifecycle

Tool	Description
tf_serve_status	Check if web server is running
tf_serve_start	Start web server in background
tf_serve_stop	Stop web server

MCP Registration

Add to ~/.claude.json:

{
  "mcpServers": {
    "taskflow": {
      "type": "stdio",
      "command": "path/to/venv/bin/python",
      "args": ["-m", "src.server"],
      "cwd": "path/to/taskflow"
    }
  }
}

Web UI

Start the web server on port 8787:

make serve    # foreground, Ctrl-C to stop
make dev      # with auto-reload
make status   # check if running
make stop     # stop the server

Or manage via MCP tools from Claude Code — ask Claude to "start the taskflow server."

Database

SQLite with WAL mode. Tables: projects, sections, tasks, tags, task_tags, tasks_fts (FTS5).

Database is created automatically on first run via db.init_db().

License

PolyForm Noncommercial 1.0.0 — free for personal and noncommercial use.