workflow-keeper

Workflow Keeper MCP

Personal workflow and task management MCP server for Claude Desktop with Turso database integration.

Quick Start

Add to your Claude Desktop config.

{
  "mcpServers": {
    "workflow-keeper": {
      "command": "npx",
      "args": ["-y", "workflow-keeper"],
      "env": {
        "TURSO_DATABASE_API_KEY": "your-token"
      }
    }
  }
}

Setup Requirements

Turso Database API Key: Get your token from Turso

• Login to Turso Dashboard
• Navigate to API Tokens
• Create a new token
• Replace your-token with your actual API key

Features

Transform your personal productivity with a complete workflow management system.

Project Management

• Create Projects: Organize work into structured projects with tasks
• Project Overview: Track progress across all your active projects
• Task Organization: Manage tasks within projects with status tracking

Task Management

• Smart Workflow: Auto-start next task when current one is completed
• Status Tracking: Track tasks through pending → in-progress → completed
• Priority Management: Organize tasks by priority levels
• Current Work View: See exactly what you're working on right now

Progress Tracking

• Real-time Status: All changes instantly synced to your personal database
• Project Progress: Visual progress tracking for each project
• Completion History: Full history of completed tasks and projects
• Work Analytics: Understand your productivity patterns

Health Check System

• Activity Logging: Record important decisions and milestones
• Progress History: Maintain a timeline of your work activities
• Custom Metadata: Add structured data to your activity records

Available Tools

Project Management

Tool	Description
setup_database	Initialize your personal Turso database
create_project	Create a new project with initial tasks
list_projects	View all projects with progress summaries
get_project_tasks	Get detailed task list for a specific project

Task Workflow

Tool	Description
get_todo_list	View all pending and active tasks across projects
start_task	Begin working on a specific task
complete_task	Mark current task as done and auto-start next
update_task	Update task details, notes, and progress
get_current_work	See what you're currently working on

Health Check & Analytics

Tool	Description
health_check	Record workflow milestones and decisions
get_health_status	Review your recent activity history

Workflow Examples

Daily Startup Routine

1. get_current_work → Check what you were working on yesterday
2. get_todo_list → Review your task pipeline  
3. start_task → Begin working on priority tasks
4. health_check → Log important decisions or milestones

Project Lifecycle

1. create_project → Start new project with initial task breakdown
2. start_task → Begin first task
3. complete_task → Finish task, auto-start next
4. get_project_tasks → Review progress anytime
5. list_projects → Check overall portfolio health

Productivity Tracking

1. health_check → Record important decisions
2. get_health_status → Review your activity patterns
3. get_current_work → Maintain focus awareness
4. update_task → Add progress notes and details

Database Management

• Personal Database: Each user gets their own Turso database instance
• Auto-initialization: Database and tables created automatically on first use
• Cloud Sync: All data stored securely in Turso's edge database network
• No Setup: No manual database configuration required

Installation

The package will be automatically downloaded and cached when you use npx:

# Test installation
npx -y workflow-keeper --version

Or install globally.

npm install -g workflow-keeper

Configuration

Environment Variables

• TURSO_DATABASE_API_KEY: Required - Your Turso API token

Database Configuration

The MCP server automatically.

• Creates a database named workflow-keeper-db in your Turso account
• Sets up all required tables (projects, tasks, health_checks)
• Handles schema migrations and updates

Use Cases

Personal Productivity

• Manage side projects and personal goals
• Track learning objectives and skill development
• Organize household tasks and maintenance schedules

Professional Development

• Break down large work projects into manageable tasks
• Track progress on quarterly objectives
• Maintain activity logs for performance reviews

Creative Projects

• Manage writing projects with chapter/section breakdowns
• Track art projects from concept to completion
• Organize content creation workflows

Learning and Development

• Structure learning paths with incremental milestones
• Track course progress and assignments
• Maintain study session logs and insights

Data Privacy

• Personal Database: Each user gets their own isolated database
• No Shared Data: Your projects and tasks are completely private
• Secure Storage: Data stored in Turso's SOC 2 compliant infrastructure
• Local Processing: All MCP operations happen locally in Claude Desktop

Troubleshooting

Common Issues

• "No API token" error: Make sure TURSO_DATABASE_API_KEY is set correctly
• Database connection issues: Verify your API token has database creation permissions
• Tool not found: Restart Claude Desktop after adding the MCP configuration

Getting Help

• Check your Claude Desktop logs for detailed error messages
• Verify your Turso account has available database quota
• Ensure your API token has not expired

License

Apache 2.0

Copyright 2025 efforthye

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Repository

https://github.com/efforthye/workflow-keeper

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.