# Reminders MCP Server

An MCP (Model Context Protocol) server for interacting with macOS Reminders app via AppleScript.

## Requirements

- macOS
- Node.js >= 18.0.0
- Access to macOS Reminders app

## Installation

```bash
npm install -g reminders-mcp
```

Or use directly with npx:

```bash
npx reminders-mcp
```

## Usage

### As an MCP Server

Add to your MCP client configuration:

```json
{
  "mcpServers": {
    "reminders": {
      "command": "npx",
      "args": ["reminders-mcp"]
    }
  }
}
```

Or if installed globally:

```json
{
  "mcpServers": {
    "reminders": {
      "command": "reminders-mcp"
    }
  }
}
```

### Development

```bash
git clone https://github.com/jagadeesh52423/remainders-mcp.git
cd remainders-mcp
npm install
npm run dev        # Run with tsx
npm run inspector  # Run with MCP inspector
```

## Available Tools

### Lists

| Tool | Description |
|------|-------------|
| `list_reminder_lists` | Get all reminder lists with names, IDs, and counts |
| `create_reminder_list` | Create a new reminder list |
| `delete_reminder_list` | Delete a list and all its reminders |
| `rename_reminder_list` | Rename an existing list |

### Reminders

| Tool | Description |
|------|-------------|
| `get_reminders` | Get reminders with filtering (list, status, priority, date range, search) |
| `get_reminder` | Get a single reminder by ID |
| `create_reminder` | Create a new reminder |
| `update_reminder` | Update reminder properties |
| `delete_reminder` | Delete a reminder |
| `complete_reminder` | Mark reminder as completed/incomplete |

### Batch Operations

| Tool | Description |
|------|-------------|
| `batch_create_reminders` | Create multiple reminders at once (max 100) |
| `batch_update_reminders` | Update multiple reminders at once (max 100) |
| `batch_complete_reminders` | Complete/uncomplete multiple reminders (max 100) |

## License

MIT