DeltaTask
A powerful MCP (Model Context Protocol) server for Claude Desktop, integrating task management, SQLite, and Obsidian visualization.
Installation
Installing for Claude Desktop
Manual Configuration Required
This MCP server requires manual configuration. Run the command below to open your configuration file:
npx mcpbar@latest edit -c claude
This will open your configuration file where you can add the DeltaTask MCP server manually.
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 propertiestags
: Stores unique tag namestodo_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 IDsearch_tasks
: Find tasks by title, description, or tagscreate_task
: Create a new taskupdate_task
: Update a task's propertiesdelete_task
: Remove a tasksync_tasks
: Sync tasks from Obsidian markdown into SQLitelist_tasks
: List all tasksget_statistics
: Retrieve metrics about taskscreate_subtasks
: Split a task into multiple subtasksget_all_tags
: Get all unique tag namesget_subtasks
: Get subtasks for a given parent taskfinish_task
: Mark a task as completed
Getting Started
Prerequisites
- Python 3.10+
- SQLite3
- Obsidian (optional, for markdown integration)
Installation
-
Clone this repository
-
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:
-
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
- Open or create
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.
- 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:
- 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
License
MIT License
Stars
7Forks
5Last commit
4 months agoRepository age
4 monthsLicense
MIT
Auto-fetched from GitHub .
MCP servers similar to DeltaTask:

Stars
Forks
Last commit

Stars
Forks
Last commit

Stars
Forks
Last commit