What is Deltatask

DeltaTask is a powerful Model Context Protocol (MCP) server designed for advanced task management, integrating SQLite database functionality and Obsidian visualization for enhanced productivity.

Use cases

Use cases for DeltaTask include managing complex projects by breaking them into subtasks, organizing tasks with tags for better context, and synchronizing tasks with Obsidian for enhanced note-taking and visualization.

How to use

To use DeltaTask, clone the repository, set up a Python environment, install dependencies, and configure the MCP server within Claude for Desktop. After configuration, you can manage tasks directly through the interface.

Key features

Key features include smart task management with urgency levels, a prioritization engine for automatic sorting, task decomposition into subtasks, a tagging system for organization, local storage using SQLite, and bi-directional sync with Obsidian markdown files.

Where to use

DeltaTask is suitable for personal productivity, project management, and any scenario requiring structured task management and visualization, particularly for users of Obsidian.

DeltaTask - Advanced Task Management System

A powerful, locally-hosted task management application with Obsidian integration and a Model Context Protocol (MCP) server.

Features

• Smart Task Management: Create tasks with urgency levels and effort estimates
• Prioritization Engine: Automatically sorts tasks by urgency and effort
• Task Decomposition: Split larger tasks into manageable subtasks
• Tagging System: Organize tasks with custom tags
• Local Storage: All data stored locally in SQLite database
• Obsidian Integration: Bi-directional sync with Obsidian markdown files
• MCP Server: Full API access through Model Context Protocol

Technical Details

Data Model

• Tasks: Core task entity with properties:
  • Title and description
  • Urgency (1-5 scale, 5 being highest)
  • Effort (1-21 scale, following Fibonacci sequence)
  • Completion status
  • Parent-child relationships for subtasks
  • Tags for categorization

Database Schema

The application uses SQLite with the following tables:

• todos: Stores all task items and their properties
• tags: Stores unique tag names
• todo_tags: Junction table for many-to-many relationship between tasks and tags

Obsidian Integration

DeltaTask creates and maintains a structured Obsidian vault:

• Task files with frontmatter metadata
• Tag-based views for filtering tasks
• Statistics dashboard
• Bi-directional sync between Obsidian markdown and SQLite database

MCP API Endpoints

The MCP server exposes the following operations:

• get_task_by_id: Get a specific task by ID
• search_tasks: Find tasks by title, description, or tags
• create_task: Create a new task
• update_task: Update a task’s properties
• delete_task: Remove a task
• sync_tasks: Sync tasks from Obsidian markdown into SQLite
• list_tasks: List all tasks
• get_statistics: Retrieve metrics about tasks
• create_subtasks: Split a task into multiple subtasks
• get_all_tags: Get all unique tag names
• get_subtasks: Get subtasks for a given parent task
• finish_task: Mark a task as completed

Getting Started

Prerequisites

• Python 3.10+
• SQLite3
• Obsidian (optional, for markdown integration)

Installation

1. Clone this repository

2. Set up the Python environment using uv:

   # Create and activate the virtual environment
   uv venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   
   # Install dependencies
   uv pip install -r requirements.txt
   

Running the MCP Server

The DeltaTask MCP server can be used with Claude for Desktop:

1. Configure Claude for Desktop:

   • Open or create ~/Library/Application Support/Claude/claude_desktop_config.json
   • Add the DeltaTask server configuration:

   {
     "mcpServers": {
       "deltatask": {
         "command": "uv",
         "args": [
           "--directory",
           "/ABSOLUTE/PATH/TO/DeltaTask",
           "run",
           "server.py"
         ]
       }
     }
   }
   

   • Restart Claude for Desktop

If you run into issues or want more details, check out the Docs for the MCP.

For instance from the docs:

You may need to put the full path to the uv executable in the command field. You can get this by running which uv on MacOS/Linux or where uv on Windows.

2. Use the DeltaTask tools in Claude for Desktop by clicking the hammer icon

Model Context Protocol (MCP)

This application implements a Model Context Protocol approach for task management:

1. Structured Data Model: Clearly defined schema for tasks with relationships
2. Priority Calculation: Intelligent sorting based on multiple factors
3. Hierarchical Organization: Parent-child relationships for task decomposition
4. Tagging System: Flexible categorization for better context
5. Statistics and Insights: Data aggregation for understanding task patterns
6. Obsidian Integration: Markdown-based visualization and editing

License

MIT License