Remind CLI

A terminal-native reminder engine with AI-powered suggestions, desktop notifications, and Claude Code integration.

Runs on macOS and Linux. Requires Python 3.12+.

Installation

Recommended (isolated environment via uv):

uv tool install remind-cli

Via pip:

pip install remind-cli

One-line installer:

curl -fsSL remind.hamzaplojovic.blog/install | sh

Verify the installation:

remind --version

Quick Start

# Create a reminder
remind add "Deploy v2.0 to production" --due "friday 3pm" --priority high

# List active reminders
remind list

# Mark a reminder as done
remind done 1

# Search by keyword
remind search "deploy"

Commands

Command	Description
`add`	Create a reminder. Flags: `--due`, `--priority`, `--project`, `--no-ai`
`list`	Show active reminders. Flags: `--all`, `--priority`, `--json`
`done`	Mark a reminder as complete by ID
`search`	Full-text search across all reminders
`login`	Authenticate with a license token
`register`	Sign up and purchase a plan via Polar checkout
`settings`	View or modify configuration. Flags: `--view`, `--set`
`usage`	View AI usage statistics for the current billing period
`scheduler`	Run the background notification daemon. Flag: `--run`
`doctor`	Run diagnostic checks on your Remind installation
`upgrade`	View available plans or change your current plan
`update`	Self-update to the latest version
`mcp`	Start the MCP server for Claude Code integration
`uninstall`	Remove Remind configuration from your system

Run remind <command> --help for detailed usage on any command.

Claude Code / MCP Integration

Remind ships with a built-in Model Context Protocol server, giving Claude Code direct access to your reminders.

Setup

Add the following to your .claude/settings.json:

{
  "mcpServers": {
    "remind": {
      "command": "remind",
      "args": ["mcp"]
    }
  }
}

Available MCP Tools

Tool	Description
`add_reminder`	Create a reminder with optional due date, priority, and project
`list_reminders`	List active or all reminders
`complete_reminder`	Mark a reminder as done
`search_reminders`	Search reminders by text
`update_reminder`	Modify an existing reminder
`delete_reminder`	Permanently remove a reminder
`agent_reminder`	Schedule Claude Code to execute a task autonomously at a future time

Pricing

All plans include the full CLI feature set. Plans differ by the number of AI-powered suggestions per month.

Plan	Price	AI Suggestions
Free	$0	5 / month
Indie	$5 / month	100 / month
Pro	$15 / month	1,000 / month
Team	$50 / month	5,000 / month

remind register

License

MIT

Metadata

Release files for remind-cli 1.3.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for remind-cli 1.3.3
File	Size	Uploaded
remind_cli-1.3.3.tar.gz	47.2 kB	Feb 17, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for remind-cli 1.3.3
File	Interpreter	ABI	Platform	Reset
remind_cli-1.3.3-py3-none-any.whl 53.2 kB Feb 17, 2026	Python 3	none	any	Details

Total release size: 100.4 kB

Release files / remind_cli-1.3.3.tar.gz

Download URL	remind_cli-1.3.3.tar.gz
Size	47.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`c151d3dfdbfc0a1e0e61153a64c1580d2ab746bf8ff0d0f65c73d741ff8ccbdd`
BLAKE2b-256 checksum How to use checksums	`c89c6462ea3282e50d1792dbdb3cfbf824cca4281f4f6d5c7ef16b2c6adeb61e`
Upload date	Feb 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.13.7`

Release files / remind_cli-1.3.3-py3-none-any.whl

Download URL	remind_cli-1.3.3-py3-none-any.whl
Size	53.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`171f13ce2bd093c0e3378116a9c547033681e265a44f51019d4d096770da12aa`
BLAKE2b-256 checksum How to use checksums	`cc0d199e54d4102dd02251eda281d9391b0772969094d1007a732882e8b9dfac`
Upload date	Feb 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.13.7`