Productivity
tasknotes avatar

tasknotes

Manage and automate Obsidian tasks directly via the TaskNotes plugin HTTP API with CLI-based task creation, listing, status updates, and project filtering.

Introduction

TaskNotes is a powerful utility for Obsidian users to integrate task management into their automated workflows. By leveraging the TaskNotes plugin's HTTP API, this skill enables seamless synchronization between your AI agent and your Obsidian vault. It serves as an interface for structured task tracking, allowing you to treat your markdown files as a programmable database.

  • Full CRUD operations: Create, read, update, and delete tasks directly from the command line.

  • Intelligent filtering: Query tasks by status (e.g., 'in-progress'), project tags, priority levels, or due dates.

  • Task property management: Modify task details, descriptions, scheduled times, and metadata without leaving your terminal.

  • Bulk orchestration: Supports listing tasks with table formatting for rapid review and status transitions.

  • Obsidian integration: Syncs perfectly with Obsidian's internal structure, utilizing markdown body text for details and frontmatter for properties.

  • Ensure the TaskNotes plugin is installed in Obsidian and the HTTP API is enabled in its settings.

  • Requires Python 3.11+ and 'uv' for dependency management.

  • API authentication is optional but supported via a root-level .env file (TASKNOTES_API_KEY).

  • Best used for morning routines (listing tasks to work on), project management (assigning tasks to specific project links), and rapid capture (adding tasks with scheduled times).

  • High-recall keywords: Obsidian task management, TaskNotes API, workflow automation, markdown task tracking, CLI task manager, personal knowledge management, automated todo lists, task scheduling, project organization.

Repository Stats

Stars
455
Forks
71
Open Issues
6
Language
Python
Default Branch
main
Sync Status
Idle
Last Synced
May 1, 2026, 09:48 AM
View on GitHub