# 📝 Todo MCP Server

A simple Todo List MCP server built for learning!

## What is this?

This is an MCP (Model Context Protocol) server that gives AI assistants (like Claude) the ability to manage a todo list for you.

### Tools Included:
- **add_todo** - Add a new task
- **list_todos** - See all your tasks
- **complete_todo** - Mark a task as done ✅
- **delete_todo** - Remove a task 🗑️

---

## 🚀 Quick Start

### 1. Install dependencies
```bash
cd todo-mcp
npm install
```

### 2. Build the project
```bash
npm run build
```

### 3. Test it works
```bash
node index.js
```
(Press Ctrl+C to stop - it will just wait for input)

---

## 🔌 Connect to Claude Desktop

Edit your Claude Desktop config file:

**Mac:** `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

Add this to the file:

```json
{
  "mcpServers": {
    "todo": {
      "command": "node",
      "args": ["/FULL/PATH/TO/todo-mcp/index.js"]
    }
  }
}
```

⚠️ **Replace `/FULL/PATH/TO/` with the actual path to your todo-mcp folder!**

Then restart Claude Desktop.

---

## 🔌 Connect to Codebuff

Create or edit `.codebuff/config.json` in your project:

```json
{
  "mcpServers": {
    "todo": {
      "command": "node",
      "args": ["/FULL/PATH/TO/todo-mcp/index.js"]
    }
  }
}
```

Or add to global config at `~/.codebuff/config.json`.

Then restart Codebuff.

---

## 💡 How to Use

Once connected, just talk to Claude naturally:

- *"Add 'buy groceries' to my todo list"*
- *"What's on my todo list?"*
- *"Mark todo #1 as complete"*
- *"Delete todo #2"*

Claude will automatically use the right tools!

---

## 📚 Learning More

Look at `index.ts` - it's full of comments explaining every part!

Key concepts:
1. **Tools** = Actions the AI can take
2. **inputSchema** = What info each tool needs
3. **Request Handlers** = Code that runs when tools are used

---

## ⚠️ Note

Todos are stored in memory only - they disappear when the server restarts. This is intentional for learning! A real app would save to a file or database.