Thinkific MCP Server

A production-quality Model Context Protocol (MCP) server for the Thinkific REST Admin API and GraphQL API. Lets AI assistants (Claude, GPT, etc.) interact with your Thinkific site directly — manage courses, students, enrollments, orders, coupons, communities, and more.

Features

• 108 MCP tools covering the full Thinkific API surface — 77 REST tools and 31 GraphQL tools
• Full REST coverage — courses, users, enrollments, orders, products, bundles, coupons, groups, instructors, reviews, promotions, categories, site scripts, external orders, publish requests, and more
• GraphQL support — queries and mutations for communities, posts, lessons, assignments, and advanced data access via https://api.thinkific.com/stable/graphql
• 3 MCP resources for quick site overview data
• Dual authentication — API Key or OAuth Bearer token
• Pagination on every list endpoint (page + limit params)
• Rate-limit awareness — automatic retry with exponential back-off on 429 responses
• Structured error handling — human-readable errors, never crashes the server
• TypeScript — fully typed, strict mode, JSDoc throughout

Quick Start

1. Install

# Clone or copy the project
cd ~/Documents/thinkific-mcp

# Install dependencies
npm install

# Build
npm run build

2. Configure Authentication

You need one of the two auth methods:

Option A: API Key (single site)

Find your API key in your Thinkific admin: Settings → Code & Analytics → API.

export THINKIFIC_API_KEY="your-api-key"
export THINKIFIC_SUBDOMAIN="your-site-subdomain"

Option B: OAuth Token (multi-site apps)

export THINKIFIC_OAUTH_TOKEN="your-oauth-bearer-token"

3. Run

# Direct
node dist/index.js

# Or via npm
npm start

Usage with Claude Desktop

Add to your Claude Desktop MCP config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "thinkific": {
      "command": "node",
      "args": ["/path/to/thinkific-mcp/dist/index.js"],
      "env": {
        "THINKIFIC_API_KEY": "your-api-key",
        "THINKIFIC_SUBDOMAIN": "your-subdomain"
      }
    }
  }
}

Usage with OpenClaw / mcporter

# Register the server
mcporter add thinkific -- node /path/to/thinkific-mcp/dist/index.js

# Set env vars
mcporter env thinkific THINKIFIC_API_KEY=your-api-key
mcporter env thinkific THINKIFIC_SUBDOMAIN=your-subdomain

# Verify tools are visible
mcporter tools thinkific

REST Tool Reference

Users

Enrollments

Courses

Chapters

Contents

Orders

Products

Bundles

Groups

Group Analysts

Group Users

Coupons

Promotions

Categories

Course Reviews

Instructors

Custom Profile Fields

External Orders

Product Publish Requests

Site Scripts

Site

GraphQL Tool Reference

GraphQL tools use the Thinkific GraphQL endpoint: https://api.thinkific.com/stable/graphql

Queries

Mutations

Resources

Environment Variables

Note: If THINKIFIC_OAUTH_TOKEN is set, it takes precedence over API Key auth.

Project Structure

thinkific-mcp/
├── src/
│   ├── index.ts       # Entry point — server bootstrap
│   ├── client.ts      # Thinkific API client (auth, pagination, retry)
│   ├── tools.ts       # MCP tool definitions and handlers (REST)
│   ├── gql-tools.ts   # MCP tool definitions and handlers (GraphQL)
│   ├── resources.ts   # MCP resource definitions
│   ├── types.ts       # TypeScript interfaces for API responses
│   └── test.ts        # Validation test script
├── dist/              # Compiled JavaScript (after build)
├── package.json
├── tsconfig.json
├── README.md
├── LICENSE
└── .gitignore

Development

# Build
npm run build

# Watch mode
npm run dev

# Type-check only
npm run lint

# Run tests (after build)
npm test

Troubleshooting

"Thinkific authentication not configured"

Set the required environment variables. You need either:

• THINKIFIC_API_KEY and THINKIFIC_SUBDOMAIN, or
• THINKIFIC_OAUTH_TOKEN

401 Authentication Error

• Verify your API key hasn't been rotated (keys are shown only once after reset)
• Confirm your Thinkific plan supports API access (Grow/Pro + Growth or above)
• Check the subdomain matches exactly (e.g. my-school, not my-school.thinkific.com)

429 Rate Limit

The server automatically retries with exponential back-off (up to 3 retries). If you're consistently hitting rate limits, reduce request frequency or add pagination with smaller page sizes.

Empty Results

• Check that you're connecting to the correct site (verify subdomain)
• Some endpoints require data to exist first (e.g. no enrollments without courses and users)

Server Won't Start

• Ensure Node.js 18+ is installed: node --version
• Run npm run build first — the server runs from dist/
• Check stderr for error messages (stdout is reserved for MCP protocol)

API Documentation

• Thinkific REST API Reference
• Thinkific GraphQL API
• API Key Authorization
• OAuth Authorization
• Rate Limits

License

MIT — see LICENSE.