# TODO Assistant MCP Server

A simple [MCP](https://modelcontextprotocol.io/) server for managing TODO tasks. Works with any MCP-compatible client.

## Setup

1. Install Python 3.10+
2. Install dependencies:
```bash
pip install -r requirements.txt
```

## Connect to your MCP client

This server uses **stdio transport** — your MCP client starts and manages the server process automatically.

Add something like this to your client's MCP config (exact location depends on the client):

```json
{
  "mcpServers": {
    "todo-assistant": {
      "command": "python3",
      "args": ["/full/path/to/server.py"]
    }
  }
}
```

Replace `/full/path/to/server.py` with the actual absolute path.

**Where to put this config:**

| Client | Config location |
|---|---|
| Claude Desktop | `~/.config/Claude/claude_desktop_config.json` (Linux) / `~/Library/Application Support/Claude/claude_desktop_config.json` (Mac) |
| Cline (VS Code) | MCP Servers section in Cline settings, or `~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json` |
| Other clients | Check your client's docs for MCP server configuration |

> After adding the config, **restart your client** so it picks up the new server.

## Tools

Once connected, your AI assistant can use these tools:

| Tool | What it does |
|---|---|
| `add_task` | Create a task (title, description, priority) |
| `list_tasks` | List all/pending/completed tasks |
| `complete_task` | Mark a task as done |
| `uncomplete_task` | Mark a task as pending |
| `update_task` | Edit a task's title, description, or priority |
| `delete_task` | Remove a task |

Just ask your assistant in natural language, e.g. "add a task to buy groceries with high priority" or "show my pending tasks".

## Storage

Tasks are saved to `tasks.json` in the server directory.