tasks

What This Skill Does

The Tasks skill is a robust interface for the OpenClaw agent to interact with your Todoist or Microsoft To-Do environments. By wrapping the command-line interfaces for these popular task management platforms, the skill allows you to maintain peak productivity without ever leaving your terminal or chat context. It enables the agent to fetch your current agenda, add urgent action items, and clear completed work items efficiently. This bridge between your planning tools and the AI agent ensures that your to-do list remains a living document that the agent can actively help you manage, prioritize, and execute upon throughout your workday.

Installation

To integrate this skill into your environment, you must ensure you have the required Python dependencies installed. Run the following command in your terminal:

pip install todoist-api-python

Next, install the OpenClaw skill package directly from the repository:

clawhub install openclaw/skills/skills/xejrax/brainz-tasks

Finally, ensure your environment variables are configured correctly. You must set either TODOIST_API_TOKEN or MSGRAPH_TOKEN in your system environment to allow the agent to authenticate with your account. Without these tokens, the skill will be unable to retrieve or modify your task lists.

Use Cases

• Daily Standup Preparation: Ask the agent to list all tasks due today to quickly summarize your progress for a morning meeting.
• Quick Capture: When working on complex tasks, use the agent to voice or type new to-dos instantly as they come to mind, ensuring you never lose track of a sudden requirement or follow-up.
• Project Management: Systematically clear out your queue by letting the agent mark items as complete as you finish them, keeping your project tracking tools perfectly synced with your actual output.
• Automated Reminders: Use the agent to set tasks with specific due dates, helping you manage long-term project deadlines alongside daily deliverables.

Example Prompts

1. "List all my pending tasks for today and identify which ones are overdue."
2. "Add a new task: 'Draft project proposal for client meeting' with a due date of Friday."
3. "Mark task 8842 as complete; I just finished reviewing the documentation."

Tips & Limitations

• Token Security: Treat your API tokens like passwords. Never hardcode them into scripts; use a secure vault or a .env file that is excluded from version control.
• Task Identification: Always verify the <task_id> before issuing a completion command, as the agent may occasionally retrieve multiple tasks with similar names.
• API Availability: This skill relies on the stability of Todoist/Microsoft APIs. If your internet connection is unstable or the service is undergoing maintenance, command execution may fail.