taskleef

# Taskleef Plugin for Claude Code

Official Claude Code plugin for [Taskleef](https://taskleef.com) - task management with natural language support.

## Features

- Create todos with natural language dates ("tomorrow", "next Monday", "in 3 days")
- Tag tasks using `[tag]` syntax in titles
- List, search, complete, and manage your tasks
- Organize with kanban boards

## Installation

### 1. Install the plugin

```bash
/plugin marketplace add Xatter/taskleef-plugin
/plugin install taskleef@Xatter/taskleef-plugin
```

### 2. Run setup

```bash
/taskleef:setup
```

This will prompt you for your API key and configure the connection to taskleef.com.

**Don't have an API key?** Get one at [taskleef.com/settings/api-keys](https://taskleef.com/settings/api-keys)

### 3. Restart Claude Code

After setup, restart Claude Code for the MCP server to connect.

## Usage

Once installed, Claude can help you manage tasks:

- "Add 'buy groceries tomorrow' to my tasks"
- "What's on my todo list?"
- "Mark the grocery task as done"
- "Show me all my work tasks"
- "Create a task to call mom next Monday [family]"

## Available Tools

| Tool | Description |
|------|-------------|
| `list_todos` | List tasks with optional filters |
| `create_todo` | Create a task (supports natural language) |
| `complete_todo` | Toggle task completion |
| `search_todos` | Search by title/description |
| `update_todo` | Update task details |
| `delete_todo` | Permanently delete a task |
| `get_inbox` | Get tasks not on any board |

## Commands

| Command | Description |
|---------|-------------|
| `/taskleef:setup` | Configure your API key |

## Manual Setup (Alternative)

If you prefer not to use the plugin's setup command:

```bash
claude mcp add --transport sse taskleef https://taskleef.com/mcp/sse -H "X-API-Key: YOUR_API_KEY"
```

## Troubleshooting

**"taskleef" MCP server already exists**
```bash
claude mcp remove taskleef
/taskleef:setup
```

**Tasks not loading**
- Verify your API key is correct at taskleef.com/settings/api-keys
- Restart Claude Code after setup

## License

MIT