Claude Code Integration
Remind is the first CLI tool with native Claude Code support. 15 MCP tools, agent reminders, and autonomous task scheduling — right inside your coding session.
$ uv tool install remind-cli
Setup
Install the CLI, add one config block, and Claude Code gains full access to your reminders.
Via uv or pip. Works on macOS and Linux.
$ uv tool install remind-cli
Paste this into your ~/.claude/settings.json to register the MCP server.
$ remind mcp
That's it. Claude now has access to all 15 tools. Just ask naturally — "Remind me to deploy on Friday" — and it picks the right tool.
Or add it globally in ~/.claude/settings.json so every project has access.
MCP Tools
Every tool is available the moment you connect. Just talk to Claude naturally — it picks the right tool automatically.
add_reminder
Create reminders from conversation with optional due date, priority, and project context.
"Remind me to deploy v2 on Friday at 3pm"
list_reminders
Check what's pending. Shows active reminders by default, with option to include completed.
"What reminders do I have this week?"
complete_reminder
Mark a reminder as done after finishing work. Uses the reminder ID number.
"Mark the deploy reminder as done"
search_reminders
Find specific reminders by text content. Case-insensitive search across all reminders.
"Find all reminders about testing"
update_reminder
Edit existing reminders — change text, due date, priority, or project. Only provided fields are changed.
"Push the deploy reminder to Monday"
delete_reminder
Permanently delete a reminder you no longer need.
"Delete reminder #5"
get_context
Get reminders filtered by your current project (auto-detected from working directory).
"Show me reminders for this project"
get_overdue
Surface all overdue reminders that need attention right now.
"What's overdue?"
get_upcoming
See reminders due within the next N hours. Defaults to 24.
"What's coming up in the next 6 hours?"
snooze_reminder
Push a reminder back by a relative duration — minutes, hours, or days.
"Snooze #12 by 2 hours"
bulk_complete
Complete multiple reminders at once with comma-separated IDs.
"Mark #3, #5, and #7 as done"
get_summary
Get a structured dashboard: overdue count, due today, by priority, by project.
"Give me a summary"
get_config
Read your Remind configuration settings.
"What's my current timezone?"
set_config
Change configuration settings like timezone or notification preferences.
"Set my timezone to US/Pacific"
agent_reminder
Headline
Schedule Claude Code to autonomously execute a task at a specific time. At the scheduled time, Claude runs with full permissions in your project directory.
"At 9am tomorrow, run the test suite and fix any failures"
Agent Reminders
Agent reminders let you schedule autonomous Claude Code tasks. When the time comes, the scheduler fires claude -p "<task>" --dangerously-skip-permissions in your project directory.
Security Warning — Agent reminders execute Claude Code with --dangerously-skip-permissions. This gives Claude full read, write, and execute access to your project directory. Only use in trusted environments where you understand the implications.
"Every morning at 9am, review yesterday's git diff and leave a summary"
Recurring daily task
"In 2 hours, run the test suite and fix any failures"
One-time delayed task
"Friday at 3pm, check all CI passes and prepare release notes"
Scheduled for a specific time
"Tonight at midnight, clean up unused imports and run linters"
Off-hours automation
"Every day at 6am, check the ETL logs for errors"
Recurring monitoring
"Sunday evening, check for outdated dependencies and open a PR"
Weekly maintenance
[AGENT:/path] prefix.
10-minute timeout
Agent tasks are killed after 10 minutes. Keep tasks focused and scoped.
No result reporting
Results are not saved back to the reminder. Check git log or output manually.
Full permissions
Uses --dangerously-skip-permissions. No sandboxing or permission scoping yet.
Use Cases
Real scenarios showing natural conversation with Claude Code and Remind.
Install Remind, connect Claude Code, and never lose track of a task again. Two minutes to set up. Free forever.
$ uv tool install remind-cli