Build with PillClaw API

RESTful API + MCP Server to integrate medication management into any workflow

API Overview

PillClaw provides a RESTful API with Bearer Token authentication. All requests and responses are in JSON format.

Base URL

https://your-domain/api/v1

Quick Start

Create an API Key in Settings > API Keys

Call the API with a Bearer Token

Example Request

curl https://your-domain/api/v1/profiles \
  -H "Authorization: Bearer pill_your_api_key"

API Endpoints

Method	Endpoint	Scope	Description
GET	/api/v1/profiles	`profiles:read`	List all profiles
POST	/api/v1/profiles	`profiles:write`	Create a profile
GET	/api/v1/medications	`medications:read`	List medications
POST	/api/v1/medications	`medications:write`	Add a medication
POST	/api/v1/logs	`logs:write`	Log medication intake
GET	/api/v1/reminders/today	`medications:read`	Today's reminders
GET	/api/v1/reminders/current	`medications:read`	Currently due medications
GET	/api/v1/stats	`stats:read`	Statistics (with adherence trends, missed time analysis, refill alerts, streaks)
GET	/api/v1/overview	`profiles:read`	Family overview (all profiles + today status + stats + alerts in one call)
GET	/api/v1/profiles/:id/summary	`profiles:read`	Single profile complete summary

MCP Server Integration

Integrate PillClaw with Claude and other AI assistants via MCP (Model Context Protocol).

Install

npx pillclaw-mcp

Environment Variables

PILLPAL_API_KEY=pill_your_api_key

Claude Desktop Configuration

{
  "mcpServers": {
    "pillpal": {
      "command": "npx",
      "args": ["-y", "pillclaw-mcp"],
      "env": {
        "PILLPAL_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Supported Tools (12)

list_profilescreate_profilelist_medicationscreate_medicationupdate_medicationrefill_medicationlog_medicationget_today_remindersget_current_remindersget_statsget_family_overviewget_profile_summary

Scopes

When creating an API Key, you can select the following scopes to restrict access:

Scope	Description
`profiles:read`	Read profile information
`profiles:write`	Create, edit, delete profiles
`medications:read`	Read medication information
`medications:write`	Add, edit, delete medications
`logs:read`	Read medication logs
`logs:write`	Create, edit medication logs
`stats:read`	Read statistics

Rate Limits

FreeFree: 50/day

ProPro: 5,000/day

Requests exceeding the limit will receive a 429 status code. Upgrade to Pro for higher quotas.

Ready to get started?

Create a free account, get your API Key, and start integrating now.