What is MCP?

The Model Context Protocol (MCP) is a standard that allows AI assistants like Claude to directly use external tools. With the Remindlo MCP server, you can manage contacts and campaigns by simply chatting with Claude.

Instead of using the API directly, you can say:

"Add John Smith, phone +447912345678, to the Birthday campaign"

And Claude will handle everything automatically.

Requirements

• Claude Desktop installed on your computer

• Node.js 22 or higher (download)

• A Remindlo API key from Dashboard → Integrations

Installation

Step 1: Get Your API Key

Go to Dashboard → Integrations and create an API key. Copy it - you'll need it in the next step.

Step 2: Configure Claude Desktop

Open your Claude Desktop configuration file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the Remindlo server configuration:

{
  "mcpServers": {
    "remindlo": {
      "command": "npx",
      "args": ["@remindlo/mcp-server"],
      "env": {
        "REMINDLO_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Replace sk_live_your_key_here with your actual API key.

Step 3: Restart Claude Desktop

Close and reopen Claude Desktop. The Remindlo tools should now be available.

Available Commands

Once connected, you can ask Claude to:

List Campaigns

"Show me my Remindlo campaigns"

"What SMS campaigns do I have?"

Add or Update Contacts

"Add Maria Garcia, phone +34612345678, email [email protected]"

"Create a contact for John Smith with phone +447912345678 and enroll him in the Appointment Reminder campaign"

"Update the contact +447912345678 - set next appointment to March 15th"

Find Contacts

"Look up the contact with phone +447912345678"

"Find all contacts due for appointments this week"

"Search for contacts named Smith"

Example Conversation

You: Add a new contact - John Smith, phone +44607123456, and sign him up for the MOT Reminder campaign

Claude: I'll add John Smith to your contacts and enroll him in the MOT Reminder campaign.

[Claude calls list_campaigns to find the campaign ID]

[Claude calls upsert_contact with the phone and campaign_ids]

Claude: Done! I've added John Smith (+48607123456) and enrolled him in the MOT Reminder campaign. He'll receive reminders according to the campaign schedule.

Phone Number Format

Always use international format with country code:

Troubleshooting

Tools not appearing in Claude

1. Make sure you've restarted Claude Desktop after editing the config

2. Check that the config file path is correct for your operating system

3. Verify the JSON syntax is valid (no trailing commas, proper quotes)

4. Ensure Node.js 22+ is installed: run node --version in terminal

"REMINDLO_API_KEY environment variable is required"

Your API key is missing or not set correctly in the config. Make sure the env section contains your key:

"env": {
  "REMINDLO_API_KEY": "sk_live_your_actual_key"
}

"Invalid API key" errors

• Verify your API key in Dashboard → Integrations

• Make sure you're using the full key (starts with sk_live_ or sk_test_)

• Check the key hasn't expired

"Network error" or connection issues

• Check your internet connection

• Verify that api.remindlo.co.uk is accessible

• If behind a corporate firewall, you may need to allow outbound HTTPS connections

Alternative: Manual Installation

If npx doesn't work, you can install globally:

npm install -g @remindlo/mcp-server

Then update your config to use the global command:

{
  "mcpServers": {
    "remindlo": {
      "command": "remindlo-mcp",
      "env": {
        "REMINDLO_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

See Also

• SMS Reminder API Documentation - for direct API integration

• Claude Desktop - download and documentation

• Model Context Protocol - MCP specification

Need Help?

Contact us at [email protected] for integration support.