1. Conduid
  2. Developer Tools
  3. Todos
MCP server · Developer Tools

Todos

by · github.com/tomelliot/todos-mcp

A todo list application implementing Model Context Protocol (MCP)

Unclaimed GPL-3.0 last commit a year ago devtools
InstallView source
49Fair

Scored 5 days ago · breakdown

About Todos

Todos is an MCP server published by tomelliot in the Developer Tools category: a todo list application implementing Model Context Protocol (MCP).

The repository has 6 stars and 5 forks, with the last commit a year ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.

Install

From source
git clone https://github.com/tomelliot/todos-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Ask AI

✦

Ask AI about Todos

Powered by Claude · Grounded in docs

I know everything about Todos. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

Static checks derived from the repository 7 days ago. Heuristics on the source, not an audit.

  • ✓README presentThe repository ships documentation.
  • ✓License declaredUsable under a stated license.
  • ✓Tests presentA test suite exists in the repository.
  • ✓Dependencies pinnedA lockfile pins dependency versions.
  • ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

Releases

v1.2.0v1.2.0 · 8 Apr 20251.2.0 (2025-04-08) Features add Get-Most-Recently-Modified-Todo tool and update docs (2009b46)

README

MCP Todo List App

A todo list application implementing Model Context Protocol (MCP), enabling seamless interaction with AI assistants and chatbots. This application is a practical todo list manager and a demonstration of MCP integration.

Features

  • ✨ Full todo list functionality (create, read, update, delete tasks)
  • 🤖 MCP-compliant API for AI assistant integration
  • 🏠 Local storage (no SaaS account required)

What is MCP?

The Model Context Protocol (MCP) is a standardized interface that allows AI models and chatbots to interact with applications in a consistent and predictable way. By implementing MCP, this todo list app can be seamlessly controlled by AI assistants, enabling natural language interactions for task management.

Getting Started

  1. Open Claude config file
  2. Add the todos server to your claude_desktop_config.json (usually found at ~/Library/Application Support/Claude/claude_desktop_config.json on MacOS)
{
  "mcpServers": {
    // ...
    "todos": {
      "command": "npx",
      "args": ["-y", "todos-mcp"]
    }
    // ...
  }
}

Development

Prerequisites

  • Node.js (v16 or higher)
  • npm or yarn

Installation

  1. Clone the repository:
git clone https://github.com/tomelliot/todos-mcp.git
cd mcp-todo-app
  1. Install dependencies:
npm install
# or
yarn install
  1. Start the development server:
npm run dev
# or
yarn dev

MCP Integration

This todo list app exposes the following MCP tools:

  • Get-Todo: Get a specific todo by ID
  • List-All-Todos: List all todos
  • List-Completed-Todos: List all completed todos
  • List-Pending-Todos: List all pending todos
  • Add-Todo: Add a todo
  • Mark-Todo-Done: Mark a todo item as completed
  • List-Due-Today: List all pending todos that are due today or overdue
  • List-Due-This-Week: List all pending todos that are due this week or earlier
  • Update-Todo: Update a todo's description and/or due date

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the GPL License - see the LICENSE file for details.

Acknowledgments

  • Built with modern web technologies
  • Implements MCP specification for AI integration
  • Inspired by the need for AI-friendly applications

README fetched from the repository 7 days ago. The original is authoritative.

Questions

About Todos

How do I install Todos?

No package has been published for this server, so install it from source: clone the repository and follow its README.

Is Todos safe to use with an AI agent?

Its trust score is 49 out of 100 (fair). It passes 5 of the 6 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is Todos still maintained?

The last commit was a year ago. That's long enough that you should check whether the maintainer is responding to issues before depending on it.