DeltaTask

by brysontang

5 stars

Not rated

GitHub

About

Integrates with Obsidian to provide a locally-hosted task management system with intelligent prioritization, task decomposition, and a full API for creating, updating, and querying tasks in a SQLite-backed database.

Details

Author: brysontang
Repository: brysontang/DeltaTask
GitHub stars: 5
License: MIT License
Categories: Productivity, Project Management, Other, Developer Tools, File Management, Search, Database, API
Tags: #integration

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name DeltaTask

Command (node, npx, python, etc.) uv
Arguments
- Argument 1 --directory
- Argument 2 /ABSOLUTE/PATH/TO/DeltaTask
- Argument 3 run
- Argument 4 server.py
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

1. Clone this repository
2. Set up the Python environment using uv:

uv venv source .venv/bin/activate # On Windows: .venv\Scripts\activate

uv pip install -r requirements.txt

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

`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.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

Linux

{
    "cwd": "string",
    "env": [],
    "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/DeltaTask",
        "run",
        "server.py"
    ],
    "shell": false,
    "command": "uv"
}

Macos

{
    "cwd": "string",
    "env": [],
    "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/DeltaTask",
        "run",
        "server.py"
    ],
    "shell": false,
    "command": "uv"
}

Windows

{
    "cwd": "string",
    "env": [],
    "args": [
        "--directory",
        "/ABSOLUTE/PATH/TO/DeltaTask",
        "run",
        "server.py"
    ],
    "shell": false,
    "command": "uv"
}

DeltaTask - Advanced Task Management System

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

- 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

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

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

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

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

Set up the Python environment usinguv:

# 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

The DeltaTask MCP server can be used with 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" ] } } }

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

You may need to put the full path to theuvexecutable in thecommandfield. You can get this by runningwhich uvon MacOS/Linux orwhere uvon Windows.
- Use the DeltaTask tools in Claude for Desktop by clicking the hammer icon

This application implements a Model Context Protocol approach for task management:
- Structured Data Model: Clearly defined schema for tasks with relationships
- Priority Calculation: Intelligent sorting based on multiple factors
- Hierarchical Organization: Parent-child relationships for task decomposition
- Tagging System: Flexible categorization for better context
- Statistics and Insights: Data aggregation for understanding task patterns
- Obsidian Integration: Markdown-based visualization and editing

MCP server to interact with Routine: calendars, tasks, notes, etc.

From the creators of Wunderlist — the all-in-one task management app for to-do lists, notes, and projects. AI-powered productivity that replaces 5 apps.

Multi-device file sync, dev-doc CRUD, task management, and session handoffs for AI agents - MCP + OpenAPI dual surface.

Portable, cloud-hosted AI memory you own - structured memories, tasks, goals, and notes that work across Claude, ChatGPT, Gemini, and any MCP client.

Allows AI assistants to read notes from the Bear note-taking app by connecting directly to its SQLite database.

Access and manage your Bear Notes from a local SQLite database.

A local-first personal CRM for the terminal — manage contacts, deals, interactions, and tasks from Claude with 18 built-in tools, all stored in a local SQLite file.

A server that enables access to Joplin notes and to-dos through the Model Context Protocol (MCP).

Connect your AI assistant to your personal knowledge base. Search, save links, create notes and to-dos. AI processes everything automatically.

Integrate OmniFocus with Claude Desktop for AI-powered task management and weekly reviews.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

get_task_by_id

search_tasks

create_task

update_task

delete_task

sync_tasks

list_tasks

get_statistics

create_subtasks

get_all_tags

get_subtasks

finish_task

Claude Desktop / Cursor

Linux

Macos

Windows

DeltaTask - Advanced Task Management System

Install

More like this

Sequential Thinking

Time

Filesystem

EverArt

Google Drive

GitLab

`get_task_by_id`

`search_tasks`

`create_task`

`update_task`

`delete_task`

`sync_tasks`

`list_tasks`

`get_statistics`

`create_subtasks`

`get_all_tags`

`get_subtasks`

`finish_task`