A powerful integration for managing Obsidian tasks, projects, and priorities through the TaskNotes plugin HTTP API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install obsidian-plugin-tasknotes
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install obsidian-plugin-tasknotes using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Obsidian TaskNotes Manager?
The TaskNotes skill is a specialized interface designed for developers and AI agents to interact directly with task data stored inside an Obsidian vault. By leveraging the TaskNotes plugin's local HTTP server, this skill enables seamless synchronization between external automation scripts and your internal knowledge base. It is a core component for those using Openclaw Skills to build personalized productivity systems that bridge the gap between markdown files and actionable task management.
This skill allows for deep control over task metadata, including projects, contexts, and scheduled dates, without requiring manual entry within the Obsidian UI. Whether you are building a custom dashboard or delegating task organization to an AI agent, this tool provides the necessary hooks to maintain a highly structured and automated workflow.
Obsidian TaskNotes Manager Use Cases
- Automatically create tasks in Obsidian from meeting notes or CLI inputs.
- Query and list pending tasks filtered by specific projects or high-priority status.
- Update task progress and status from "todo" to "done" using simple terminal commands.
- Manage complex project schedules by updating due dates and time estimates programmatically.
How Obsidian TaskNotes Manager Works
- The skill communicates with the TaskNotes plugin's HTTP API running locally on a user-defined port.
- Commands are issued via a Python script (tasks.py) which handles authentication and request formatting.
- The skill translates CLI parameters into RESTful API calls (GET, POST, PUT, DELETE) sent to the Obsidian vault.
- Obsidian updates the underlying markdown files or frontmatter based on the API request.
- The agent receives a structured response, providing immediate feedback on the success of the task operation.
Obsidian TaskNotes Manager Setup
To integrate this capability into your Openclaw Skills workflow, follow these installation steps:
- Install the TaskNotes plugin within your Obsidian vault.
- Navigate to Obsidian Settings -> TaskNotes and enable the "HTTP API" toggle.
- Set your preferred API port (default is 8080).
- (Optional) Set an API token for security and add it to a
.envfile in your vault root:
TASKNOTES_API_PORT=8080
TASKNOTES_API_KEY=your_token_here
- Test the connection by listing your current task projects:
uv run scripts/tasks.py options --table
Obsidian TaskNotes Manager Data Schema & Taxonomy
The skill manages task data using a structured metadata approach. The following fields are supported within the vault's task system:
| Property | Format | Description |
|---|---|---|
status |
String | User-defined status (e.g., todo, in-progress) |
projects |
Array | Markdown links to project notes (e.g., [[Project A]]) |
priority |
String | Importance level mapped in plugin settings |
due |
Date | YYYY-MM-DD format for deadlines |
scheduled |
ISO8601 | YYYY-MM-DDTHH:MM:SS for specific start times |
timeEstimate |
Number | Duration in minutes |
details |
String | Markdown content written to the task body |
Obsidian TaskNotes Manager Advanced Features
- Support for custom status workflows defined within Obsidian settings.
- Human-readable table output for CLI-based task reviews.
- Advanced filtering capabilities including overdue status and specific tag queries.
- Seamless project linking using standard Obsidian markdown syntax.
- Granular task updates allowing for partial modifications of descriptions or metadata without overwriting the entire note.
SKILL.md
Loading
Related Openclaw Skills
DataFast Analytics
A comprehensive tool for querying DataFast website analytics, visitor metrics, and managing conversion goals via API.
Trackyard
A professional-grade music search and clipping tool for AI agents to find and download licensed background tracks.
Skill Soup Runner (Dev)
An autonomous skill-generation agent that transforms community ideas into fully-functional Openclaw Skills through an evolutionary ecosystem.
BenOS Memory Core
A high-performance runtime memory module for BenOS agents to manage session states, active initiatives, and decision logging.
Clawdio
Clawdio transforms Twitter Spaces and voice conversations into structured, machine-readable intelligence for AI agents.
Clawdio
Clawdio provides auditory perception for AI agents, converting human audio into structured data, semantic reports, and machine-readable markdown.
Featured*
