Features

What milk-mcp does

Session Memory

Claude picks up exactly where it left off. Start and end sessions with automatic context loading and saving.

TODO Tracking

Manage tasks with priorities. Add, complete, and promote items from backlog to active TODOs.

Bug Tracking

Log bugs as you find them. Separate list keeps issues organized without cluttering your TODOs.

Decisions Log

Record architectural decisions with context. Never wonder "why did we do it this way?" again.

Installation

Get started in 5 minutes

Prerequisites

You'll need:

Remember The Milk account (free tier works)
Node.js 18+ installed
Claude Code CLI

Get RTM API Credentials

Apply for an API key at RTM's API page. This usually takes a few hours to approve.

You'll receive an API Key and Shared Secret.

Clone and Setup

          # Clone the repository
git clone https://github.com/donkitchen/milk-mcp.git
cd milk-mcp

# Install dependencies
npm install

# Build the project
npm run build
        

Authenticate with RTM

Run the authentication script:

npm run auth

This will:

Prompt for your API Key and Shared Secret
Open a browser to authorize the app
Save your auth token to ~/.milk-mcp/config.json

Configure Claude Code

Add milk-mcp to your Claude Code MCP settings. Edit ~/.claude/claude_desktop_config.json:

          {
  "mcpServers": {
    "milk-mcp": {
      "command": "node",
      "args": ["/path/to/milk-mcp/dist/index.js"]
    }
  }
}
        

Replace /path/to/milk-mcp with the actual path where you cloned the repo.

Setup Your First Project

In Claude Code, set up a project:

          # Claude will call rtm_setup_project
"Set up milk-mcp for the my-project project"

# Start a session
"Start a session for my-project"

# End session when done
"Wrap up"
        

Add this to your project's CLAUDE.md for automatic session management:

          ## RTM Session Management

Use the milk-mcp tools for persistent memory across sessions:

- Session start: Call `rtm_session_start` with project name
- Session end: When user says "wrap up", call `rtm_session_end`

Troubleshooting

Common issues

MCP server not connecting?

Make sure the path in your config is absolute (starts with /), not relative. Restart Claude Code after changing the config.

Authentication failed?

Re-run npm run auth to refresh your token. Make sure your API key hasn't expired.

Project not found?

Run rtm_setup_project first to create the RTM lists for your project. The project name should match your directory name.

Need more help?

Check the GitHub Issues or open a new one.