codethenpizza/mcp-server-todo-tutorial

MCP Todo Server

A simple Model Context Protocol (MCP) server that demonstrates how to build MCP applications. This server provides todo list functionality with tools and resources for task management.

Features

• Create Tasks: Add new tasks to your todo list
• Manage Tasks: Update, complete, and delete tasks
• Filter Tasks: Get tasks by completion status
• Task Analytics: Analyze task patterns and statistics

Installation

1. Clone this repository:

git clone https://github.com/codethenpizza/mcp-server-todo-tutorial
cd mcp-tutorial

2. Install dependencies:

npm install

3. Build the server:

npm run build

Adding to Claude Desktop

To use this MCP server with Claude Desktop, you need to add it to your Claude Desktop configuration (read more here):

macOS/Linux

1. Open your Claude Desktop config file:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

2. Add the MCP server to your configuration:

{
  "mcpServers": {
    "todo": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-tutorial/dist/server.js"]
    }
  }
}

Windows

1. Open your Claude Desktop config file at: %APPDATA%\Claude\claude_desktop_config.json

2. Add the MCP server using the same JSON configuration as above, but with Windows-style paths:

{
  "mcpServers": {
    "todo": {
      "command": "node",
      "args": ["C:\\absolute\\path\\to\\mcp-tutorial\\dist\\server.js"]
    }
  }
}

Important Notes

• Use absolute paths: Replace /absolute/path/to/mcp-tutorial with the actual full path to your project directory
• Build first: Ensure you've run npm run build before adding to Claude Desktop
• Restart Claude Desktop: After making configuration changes, restart Claude Desktop for them to take effect

Development

• npm run dev - Run server in development mode
• npm run build - Build the TypeScript code
• npm run watch - Build and watch for changes

Usage with Claude

Once configured, you can ask Claude to help you manage your todos:

• "remind me to buy groceries"
• "Show me all my incomplete tasks"
• "Mark task as completed"
• "Analyze my task completion patterns"

Note

This is a simplified showcase implementation. Some features are intentionally basic to demonstrate core MCP concepts.