What is Mcp Tdo

mcp-tdo is a Model Context Protocol (MCP) server designed to help AI models manage and access your todo notes and tasks using the tdo CLI tool.

Use cases

Use cases for mcp-tdo include automating task management for personal projects, integrating with AI systems to provide intelligent task suggestions, and enhancing productivity workflows by allowing easy access to todo notes.

How to use

To use mcp-tdo, ensure that you have Python 3.10+ and the tdo CLI tool installed. After setting up the mcp-server, you can interact with your todo notes through the CLI commands provided by tdo.

Key features

Key features include retrieving todo note contents for specific dates, searching across all notes, listing pending todos, marking todos as complete, and adding new items to existing notes. It is fully compatible with the MCP specification.

Where to use

mcp-tdo can be used in personal productivity applications, task management systems, and any environment where managing todo lists is essential.

mcp-tdo is a Model Context Protocol (MCP) server that allows AI models to access and manage your todo notes and tasks through the tdo CLI tool.

✨ Features

• Retrieve todo note contents for today, tomorrow, or any date offset
• Search across all notes for specific content
• List all pending todos across all your notes
• Mark specific todos as complete
• Add new todo items to existing note files
• Fully compatible with the MCP specification

⚡ Setup

⚙️ Requirements

• Python 3.10+
• tdo CLI tool installed and accessible in your PATH
• mcp-server >= 0.1.1
• pydantic >= 2.0.0

💻 Installation

Installing mcp-tdo is simple:

git clone https://github.com/2kabhishek/mcp-tdo
cd mcp-tdo
pip install .

🚀 Usage

Run the server directly:

python -m mcp_tdo

Or specify a custom path to the tdo executable:

python -m mcp_tdo --tdo-path /path/to/tdo.sh

🧩 Available Tools

get_todo_contents

Shows contents of todo notes for today or a specific date offset.

Parameters:

• offset: (optional) Offset like “1” for tomorrow, “-1” for yesterday, etc.

search_notes

Searches for notes matching a query term.

Parameters:

• query: Search query term

get_pending_todos

Shows all pending todos (unchecked checkboxes) from all your notes.

No parameters required.

mark_todo_done

Marks a specific todo item as done.

Parameters:

• file_path: Path to the file containing the todo
• todo_text: Text of the todo item to mark as done

add_todo

Adds a new todo item to a specified file.

Parameters:

• file_path: Path to the file to add the todo to
• todo_text: Text of the todo item to add

🏗️ What’s Next

✅ To-Do

• [x] Setup repo
• [x] Implement basic MCP server
• [x] Add core todo management functionality
• [ ] Add ability to create new todo notes
• [ ] Modularize code
• [ ] Publish to PyPI
• [ ] Add CI / CD
• [ ] Update screenshot

🧑‍💻 Behind The Code

🌈 Inspiration

mcp-tdo was inspired by the need to give AI assistants access to personal task management tools, allowing for more productive interactions with AI models.

💡 Challenges/Learnings

• Implementing proper error handling and command execution
• Working with the MCP protocol specification
• Managing file path and content operations safely

🧰 Tooling

• dots2k — Dev Environment
• nvim2k — Personalized Editor
• sway2k — Desktop Environment
• qute2k — Personalized Browser

🔍 More Info

• shelly — Command line template
• tiny-web — Web app template

---