get_task_by_idLABSCO SUMMARY
Tasks the agent can edit and you can still read in Obsidian.
Two-way sync is what stops this being another silo: the model writes to SQLite, you edit the markdown, and sync_tasks reconciles. The urgency-and-effort pair is more useful than a flat priority field — it gives the sorting something to work with, and it makes "split this" a natural next step when the effort estimate is large.
What it is
A task system that stores everything locally in SQLite, keeps a structured Obsidian vault in sync with it in both directions, and exposes the whole API over MCP so an assistant can create, split, search and complete tasks.
What you get
- Task operations —
create_task,list_tasks,get_task_by_id,update_task,delete_task,finish_task - Search and organisation —
search_tasksby title, description or tags,get_all_tags - Decomposition —
create_subtaskssplits a task into several,get_subtasksreads the children of a parent - Reporting and sync —
get_statisticsfor metrics about tasks,sync_tasksto pull Obsidian markdown changes back into SQLite - Prioritisation is built in: tasks carry urgency on a 1-5 scale and effort on a Fibonacci 1-21 scale, and are sorted by both
- The Obsidian vault gets task files with frontmatter, tag-based views and a statistics dashboard
Requirements
Python 3.10+ and SQLite3; Obsidian is optional and only needed for the markdown side. Clone the repo, create the environment with uv venv, install with uv pip install -r requirements.txt, then add the uv --directory <YOUR_PATH_TO_DELTA_TASK> run server.py command to claude_desktop_config.json — use the full path to uv if the command is not found. All data stays local. Package version 0.1.0. MIT.
Setup effort
Build from source — git clone https://github.com/brysontang/DeltaTask.git
USE CASES
01
Deciding what to do next
List tasks sorted by urgency and effort, and let the model argue for the top one.
02
Breaking down something too big to start
Split the task into subtasks in one call, then work the children.
03
Capturing work from a conversation
Create the task with urgency, effort and tags as it comes up, without switching apps.
04
Reconciling edits you made in Obsidian
Sync the markdown changes back into the database so both sides agree.
12 tools
Listed in project docs. Your client may show a different list.
search_taskscreate_taskupdate_taskdelete_tasksync_taskslist_tasksget_statisticscreate_subtasksget_all_tagsget_subtasksfinish_taskBEFORE YOU INSTALL
What to know first
Tools you get
12 tools named in the project's documentation.
Requires
Python 3.10+
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone this one yourself.
Server setup
TERMINAL
git clone https://github.com/brysontang/DeltaTask.git
cd DeltaTask
uv venv
source .venv/bin/activate
uv pip install -r requirements.txtThen add the block below; <YOUR_PATH_TO_DELTA_TASK> is the folder you cloned. If Claude cannot find uv, put the full path from which uv in command.
MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"deltatask": {
"command": "uv",
"args": [
"--directory",
"<YOUR_PATH_TO_DELTA_TASK>",
"run",
"server.py"
]
}
}
}
