Spark
Sign In
MCP Connector

Manage Tasks with AI Assistants

Simple local todo list manager with due-date tracking, requiring no SaaS account - full CRUD via MCP.

Connect
Works with claude
tomelliot
Maintainer?
86
Spark score
out of 100
Updated Apr 2025
Fresher alternatives ↓
Version 1.2.0
Models
universal
Add to Favorites

Why it matters

Integrate AI assistants with your local task list for seamless natural language task management. Enables AI to create, update, and query tasks without external accounts.

Outcomes

What it gets done

01

Create, update, and delete tasks via natural language commands.

02

Query tasks by ID, status, or due date.

03

Mark tasks as complete.

04

Integrate with AI assistants using the MCP specification.

Install

Add it to your toolbox

Run in your project directory:

curl -fsSL https://spark.entire.vc/get/vb-todos | bash

Capabilities

Tools your agent gets

Get-Todo

Get a specific task by ID

List-All-Todos

List all tasks

List-Completed-Todos

List all completed tasks

List-Pending-Todos

List all pending tasks

Add-Todo

Add a task

Mark-Todo-Done

Mark a task as completed

List-Due-Today

List all pending tasks that are due today or overdue

List-Due-This-Week

List all pending tasks that are due this week or earlier

Update-Todo

Update a task's description and/or due date

Overview

Todos MCP Server

Todos MCP Server gives Claude a local, account-free todo list with full CRUD support and due-date filtering. Use it for simple local task tracking on a single device. It does not sync across devices or support team task management.

What it does

Todos MCP Server is a local-storage todo list application exposed via MCP, letting Claude create, list, update, and complete tasks, including due-today and due-this-week filtering, without any SaaS account.

When to use - and when NOT to

Use it for simple, local task tracking directly from Claude: adding todos, checking what's due today or this week, marking items done, or updating a todo's description or due date. Because it uses local storage rather than a cloud service, it is suited to single-device personal task tracking rather than multi-device sync or team task management.

Capabilities

  • Get-Todo: get a specific todo by ID.
  • List-All-Todos, List-Completed-Todos, List-Pending-Todos: list todos by status.
  • Add-Todo: add a new todo.
  • Mark-Todo-Done: mark a todo as completed.
  • List-Due-Today, List-Due-This-Week: list pending todos due today/overdue, or due this week or earlier.
  • Update-Todo: update a todo's description and/or due date.

How to install

{
  "mcpServers": {
    "todos": {
      "command": "npx",
      "args": ["-y", "todos-mcp"]
    }
  }
}

Add this to claude_desktop_config.json. Requires Node.js v16 or higher. Also installable from source (git clone, npm install, npm run dev).

Who it's for

People who want a simple, local todo list that Claude can manage directly, without setting up an account with a third-party task management service.

Source 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

FAQ

Common questions

Discussion

Questions & comments · 0

Sign In Sign in to leave a comment.