RTM MCP Server

A production-quality Model Context Protocol (MCP) server for Remember The Milk task management.

Enables Claude to manage your tasks through natural language conversation.

Features

• Full RTM API Coverage: 30+ tools covering tasks, lists, tags, notes, and more

• Smart Add Syntax: Natural language task creation ("Call mom ^tomorrow !1 #family")

• Undo Support: All write operations return transaction IDs for undo

• Async Performance: Built on httpx with connection pooling

• Type Safety: Full Pydantic models and type hints

Installation

Using uvx (Recommended)

Using pip

From Source

Setup

1. Get RTM API Credentials

1. Go to RTM API Keys

2. Create a new API key

3. Note your API Key and Shared Secret

2. Run Setup

This will:

• Prompt for your API credentials

• Open your browser for authorization

• Save the auth token to ~/.config/rtm-mcp/config.json

3. Configure Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

Usage

Once configured, you can ask Claude to manage your tasks:

• "Show my tasks due today"

• "Add a task to buy groceries tomorrow, high priority"

• "Complete the grocery task"

• "What high priority tasks do I have?"

• "Move the meeting prep task to my Work list"

• "Add a note to the project task"

Smart Add Syntax

When adding tasks, use RTM's Smart Add syntax:

Example: "Review report ^friday !1 #work =1h *weekly"

Available Tools

Tasks

• list_tasks - List tasks with filters

• add_task - Create a new task

• complete_task / uncomplete_task - Mark done or reopen

• delete_task - Remove a task

• postpone_task - Move due date by one day

• move_task - Move to different list

• set_task_name - Rename task

• set_task_due_date - Change due date

• set_task_priority - Set priority level

• set_task_recurrence - Set repeat pattern

• set_task_start_date - Set start date

• set_task_estimate - Set time estimate

• set_task_url - Attach URL

• add_task_tags / remove_task_tags - Manage tags

Notes

• add_note - Add note to task

• edit_note - Edit existing note

• delete_note - Remove note

• get_task_notes - View all notes

Lists

• get_lists - List all lists

• add_list - Create new list

• rename_list - Rename list

• delete_list - Delete list

• archive_list / unarchive_list - Archive management

• set_default_list - Set default list

Utilities

• test_connection - Test API connectivity

• check_auth - Verify authentication

• get_tags - List all tags

• get_locations - List saved locations

• get_settings - View user settings

• get_contacts / get_groups - Contact management

• parse_time - Parse natural language time

• undo - Undo previous operation

Configuration

Environment Variables

Config File

~/.config/rtm-mcp/config.json:

Development

Docker

Claude Desktop config for Docker:

License

MIT License - see LICENSE for details.

Acknowledgments

• Remember The Milk for the excellent task management service

• FastMCP for the MCP framework

• Anthropic for Claude and the MCP specification