Moo Tasks

A kanban-style task management dashboard with an integrated MCP server.
Human users manage tasks via a drag-and-drop web UI, while AI agents connect via the MCP server to discover, accept, update, and create tasks programmatically.

✨ Features

🚀 Quick Start

Prerequisites

• Node.js 22+
• npm

Install & Run

# Install dependencies
npm install

# Set session secret (required)
export NUXT_SESSION_PASSWORD="your-secret-key-at-least-32-characters-long"

# Start development server
npm run dev

### Docker Setup

If you have Docker installed, you can start the entire stack (including the database, Adminer, and Mailpit) with:

```bash
docker-compose up -d

The application will be available at http://localhost:3000.

The app runs at http://localhost:3000:

1. Register an account at /register
2. Create a board from the dashboard
3. Add tasks and manage your kanban board
4. Connect AI agents to the board's MCP endpoint

Seed sample data (optional): npx tsx server/db/seed.ts

⚙️ Environment Variables

Copy .env.example to .env and adjust as needed:

🤖 MCP Server

Each board has its own MCP endpoint at /api/boards/:boardId/mcp. AI agents connect to a specific board to work on its tasks.

📋 Working with Tasks via MCP

The board acts as the primary task list for this application. To programmatically work on tasks:

1. Get the MCP Token: In the Board Settings, generate an MCP token if the board is private.
2. Configure Your Agent: Add the MCP server configuration for your specific board.
3. Use Tools: Use the available tools (list-tasks, accept-task, update-task-status, etc.) to interact with the tasks.

🔐 Security & Privacy

Tokens can be generated, rotated, or revoked at any time from Board Settings.

🛠️ Tools

📚 Resources

💬 Prompts

🔄 Task Hierarchy & Corrections

Moo Tasks supports a refined workflow for task completion:

• Review Status — Move tasks to "Review" when ready for human verification
• Request Corrections — From "Review" or "Done", create linked "Correction Tasks"
• Linked Navigation — Correction tasks link to their parent for easy navigation

Configurable Instructions

Both support reset to default to restore the original built-in instructions.

🔌 MCP Client Configuration

{
  "mcpServers": {
    "moo-tasks": {
      "type": "streamable-http",
      "url": "http://localhost:3000/api/boards/<boardId>/mcp?token=<your-bearer-token>"
    }
  }
}

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "moo-tasks": {
      "type": "streamable-http",
      "url": "http://localhost:3000/api/boards/<boardId>/mcp?token=<your-bearer-token>"
    }
  }
}

Add to settings or .vscode/mcp.json:

{
  "mcpServers": {
    "moo-tasks": {
      "type": "streamable-http",
      "url": "http://localhost:3000/api/boards/<boardId>/mcp?token=<your-bearer-token>"
    }
  }
}

📡 API Routes

🐳 Docker

Build & Run

# Build
docker build -t moo-tasks .

# Run
docker run -p 3000:3000 \
  -e NUXT_SESSION_PASSWORD="your-secret" \
  -e DATABASE_URL="mysql://user:pass@host:3306/db" \
  moo-tasks

☁️ Deploy to DigitalOcean App Platform

• A DigitalOcean account
• Your repo pushed to GitHub
• A DigitalOcean API token

1. Fork/push this repo to GitHub
2. Go to DigitalOcean App Platform → Create App
3. Connect your GitHub repo and select the main branch
4. DigitalOcean will auto-detect the Dockerfile — confirm the settings
5. Under Environment Variables, add these secrets:
   • NUXT_SESSION_PASSWORD — 32+ character secret for session encryption
   • DATABASE_URL — Your MySQL connection string
6. Deploy!

Note: MySQL is recommended for production as it allows you to increase instance_count to handle more traffic.

# Install doctl and authenticate
doctl auth init

# Create the app from the spec (update repo in .do/app.yaml first)
doctl apps create --spec .do/app.yaml

# Set secrets
doctl apps update <app-id> --spec .do/app.yaml

The included workflow at .github/workflows/deploy.yml automatically:

• On pull requests — builds and validates the project
• On push to main — builds, then deploys to DigitalOcean App Platform

Setup:

1. Create the app on DigitalOcean first (Option 1 or 2)
2. Generate a DigitalOcean API token
3. Add it as a GitHub repository secret:
   • Go to Settings → Secrets and variables → Actions
   • Add DIGITALOCEAN_ACCESS_TOKEN with your DO API token
4. Push to main — the workflow will deploy automatically

The .do/app.yaml file defines the full app configuration:

name: moo-tasks

services:
  - name: web
    dockerfile_path: Dockerfile
    github:
      branch: main
      deploy_on_push: true
    http_port: 3000
    instance_count: 1
    instance_size_slug: apps-s-1vcpu-1gb
    envs:
      - key: NUXT_SESSION_PASSWORD
        type: SECRET
      - key: DATABASE_URL
        type: SECRET

• "Only board owners can invite users" or missing boards after creation: Ensure DATABASE_URL is correctly configured and the MySQL server is accessible from the app.
• Scalability: Unlike SQLite, you can increase instance_count to handle more traffic, as all instances share the same MySQL database.
• Session Reset: If the database is reset but your browser still has a session cookie, the app will automatically log you out. Simply register again to start fresh.

🧱 Tech Stack

_{Built with 🐄 by the Moo Tasks team}