tasknotes

What This Skill Does

The tasknotes skill serves as a powerful bridge between your AI agent and your Obsidian vault. By leveraging the TaskNotes plugin HTTP API, this skill allows you to programmatically manage your task lifecycle directly from your terminal or AI-driven workflows. It enables you to create, list, update, and delete tasks within your notes without ever leaving your editor. Whether you are tracking complex projects or managing daily to-do lists, tasknotes ensures your Obsidian vault remains the single source of truth for your productivity.

Installation

To get started, first ensure the TaskNotes plugin is installed in your Obsidian vault. Navigate to Obsidian Settings, select the TaskNotes plugin, and enable the 'HTTP API' toggle. If you require authentication, set an API token; otherwise, it can be left blank. For local configurations requiring auth, create a .env file at your vault root containing TASKNOTES_API_PORT and TASKNOTES_API_KEY. Finally, install the skill via the OpenClaw hub using: clawhub install openclaw/skills/skills/benoitjadinon/obsidian-plugin-tasknotes.

Use Cases

• Project Management: Track progress across different workflows by filtering tasks by project names.
• Daily Planning: Use scheduled dates and times to organize your calendar and prioritize deep work.
• Status Tracking: Quickly move items through your custom workflow statuses (e.g., 'to-do', 'in-progress', 'done').
• Automated Logging: Let your AI agent log tasks automatically during brainstorming or research sessions.

Example Prompts

1. "Create a task called 'Prepare quarterly report' in the 'Operations' project with high priority."
2. "Show me all in-progress tasks that are due by the end of this week."
3. "Mark the task 'Draft blog post' as done and add a note that it has been sent to review."

Tips & Limitations

• Consistency: Use the options command frequently to view your current status and priority configuration to avoid errors when filtering or updating.
• Performance: For very large vaults, use the limit and offset parameters in the API to prevent slow response times.
• Structure: Remember that task details are written directly to the markdown body; ensure your Obsidian templates are compatible with TaskNotes formatting for the best experience. Always keep your local environment variables in sync with your plugin settings to ensure uninterrupted connectivity.