Thinkific MCP Server
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/graphql3 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
Related MCP server: Shopmonkey MCP Server
Quick Start
1. Install
# Clone or copy the project
cd ~/Documents/thinkific-mcp
# Install dependencies
npm install
# Build
npm run build2. 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 startUsage 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 thinkificREST Tool Reference
Users
Tool | Description | Key Parameters |
| List all users/students |
|
| Get user details by ID |
|
| Create a new user |
|
| Search users by email/name |
|
| Update user details |
|
| Delete a user |
|
Enrollments
Tool | Description | Key Parameters |
| List enrollments (filterable) |
|
| Enroll a user in a course |
|
| Get enrollment details by ID |
|
| Update an enrollment |
|
Courses
Tool | Description | Key Parameters |
| List all courses with pagination |
|
| Get a single course by ID |
|
Chapters
Tool | Description | Key Parameters |
| List chapters in a course |
|
| Get chapter details by ID |
|
Contents
Tool | Description | Key Parameters |
| List lessons in a chapter |
|
| Get content/lesson details by ID |
|
Orders
Tool | Description | Key Parameters |
| List orders (filterable) |
|
| Get order details by ID |
|
Products
Tool | Description | Key Parameters |
| List all products |
|
| Get product details by ID |
|
| List related products |
|
Bundles
Tool | Description | Key Parameters |
| List course bundles |
|
| Get bundle details by ID |
|
| List courses in a bundle |
|
| List bundle enrollments |
|
| Enroll a user in a bundle |
|
| Update a bundle enrollment |
|
Groups
Tool | Description | Key Parameters |
| List all groups |
|
| Get group details by ID |
|
| Create a new group |
|
| Delete a group |
|
Group Analysts
Tool | Description | Key Parameters |
| List analysts for a group |
|
| Add an analyst to a group |
|
| Remove an analyst from a group |
|
Group Users
Tool | Description | Key Parameters |
| Add a user to a group |
|
Coupons
Tool | Description | Key Parameters |
| List all coupons |
|
| Create a discount code |
|
| Get coupon details by ID |
|
| Update a coupon |
|
| Delete a coupon |
|
| Bulk create coupons |
|
Promotions
Tool | Description | Key Parameters |
| List promotions |
|
| Create a promotion |
|
| Get promotion details by ID |
|
| Update a promotion |
|
| Delete a promotion |
|
| Get promotion for a coupon code |
|
Categories
Tool | Description | Key Parameters |
| List categories |
|
| Create a new category |
|
| Get category details by ID |
|
| Update a category |
|
| Delete a category |
|
| List products in a category |
|
| Add products to a category |
|
| Remove products from a category |
|
Course Reviews
Tool | Description | Key Parameters |
| List reviews (filterable) |
|
| Create a course review |
|
| Get review details by ID |
|
Instructors
Tool | Description | Key Parameters |
| List instructors |
|
| Create an instructor profile |
|
| Get instructor details by ID |
|
| Update an instructor profile |
|
| Delete an instructor profile |
|
Custom Profile Fields
Tool | Description | Key Parameters |
| List all custom profile fields | (none) |
External Orders
Tool | Description | Key Parameters |
| Create an external order |
|
| Refund an external order |
|
| Process an external order purchase |
|
Product Publish Requests
Tool | Description | Key Parameters |
| List product publish requests |
|
| Get a publish request by ID |
|
| Approve a publish request |
|
| Deny a publish request |
|
Site Scripts
Tool | Description | Key Parameters |
| List all site scripts |
|
| Create a site script |
|
| Get site script details by ID |
|
| Update a site script |
|
| Delete a site script |
|
Site
Tool | Description | Key Parameters |
| Site overview (counts and settings) | (none) |
GraphQL Tool Reference
GraphQL tools use the Thinkific GraphQL endpoint: https://api.thinkific.com/stable/graphql
Queries
Tool | Description | Key Parameters |
| Fetch site details via GraphQL | (none) |
| Get current authenticated user | (none) |
| Get course details by ID |
|
| Get course details by slug |
|
| Get user details by ID |
|
| Get user details by email |
|
| Get bundle details by ID |
|
| Get category details by ID |
|
| Get chapter details by ID |
|
| Get lesson details by ID |
|
| Get group details by ID |
|
| Get product details by ID |
|
| Get community details by ID |
|
| Get community user details |
|
| Get a community post by ID |
|
| Get a community space by ID |
|
Mutations
Tool | Description | Key Parameters |
| Create a community post |
|
| Reply to a community post |
|
| Update a community post |
|
| Follow a community post |
|
| Unfollow a community post |
|
| Pin a community post |
|
| Unpin a community post |
|
| Move a post to another space |
|
| React to a community post |
|
| Bulk add users to groups |
|
| Bulk remove users from groups |
|
| Mark a lesson as incomplete for a user |
|
| Mark a lesson as viewed/complete for a user |
|
| Update an assignment submission |
|
| Update a product via GraphQL |
|
Resources
Resource URI | Description |
| JSON listing of all courses (first 100) |
| JSON listing of all users (first 100) |
| JSON overview with total counts |
Environment Variables
Variable | Required | Description |
| Yes (API Key auth) | Your Thinkific API key from Settings → Code & Analytics → API |
| Yes (API Key auth) | Your Thinkific site subdomain (e.g. |
| Yes (OAuth auth) | OAuth2 Bearer token (alternative to API Key auth) |
Note: If
THINKIFIC_OAUTH_TOKENis 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
└── .gitignoreDevelopment
# Build
npm run build
# Watch mode
npm run dev
# Type-check only
npm run lint
# Run tests (after build)
npm testTroubleshooting
"Thinkific authentication not configured"
Set the required environment variables. You need either:
THINKIFIC_API_KEYandTHINKIFIC_SUBDOMAIN, orTHINKIFIC_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, notmy-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 --versionRun
npm run buildfirst — the server runs fromdist/Check stderr for error messages (stdout is reserved for MCP protocol)
API Documentation
License
MIT — see LICENSE.
Available Tools
109 toolsadd_group_analystC
Add a user as an analyst (manager) for a group.
Inputs: group_id (required), user_id (required).
add_products_to_categoryC
Add products to a category (collection membership).
Inputs: category_id (required), product_ids (required).
add_user_to_groupC
Add a user to a group.
Inputs: group_id (required), user_id (required).
approve_publish_requestC
Approve a product publish request.
Inputs: request_id (required).
bulk_create_couponsC
Bulk-create multiple coupon codes at once under a promotion.
Inputs: promotion_id (required), codes (required), quantity, note.
create_bundle_enrollmentC
Enroll a user in a bundle.
Inputs: bundle_id (required), user_id (required), activated_at, expiry_date.
create_categoryC
Create a new category (collection) for organizing products.
Inputs: name (required), description.
create_couponB
Create a new coupon/discount code. Requires a promotion_id — use list_promotions first to get one.
Inputs: promotion_id (required), code (required), note, quantity.
create_course_reviewC
Create a course review.
Inputs: course_id (required), user_id (required), rating (required), title, +1 more.
create_enrollmentC
Enroll a user in a course.
Inputs: course_id (required), user_id (required), activated_at, expiry_date.
create_external_orderC
Create an external order for a user (for purchases made outside Thinkific).
Inputs: user_id (required), product_id (required), amount_cents (required), coupon_code.
create_groupC
Create a new group on the Thinkific site.
Inputs: name (required).
create_instructorC
Create a new instructor profile.
Inputs: first_name (required), last_name (required), email, title, +2 more.
create_promotionA
Create a new promotion (discount). Promotions hold coupon codes. Create a promotion first, then create coupons under it.
Inputs: name (required), discount_type (required), amount (required), product_ids, +3 more.
create_site_scriptC
Create a new site script (custom JS/CSS snippet).
Inputs: name (required), content (required), location (required), enabled.
create_userC
Create a new user/student on the Thinkific site.
Inputs: first_name (required), last_name (required), email (required), password, +3 more.
delete_categoryC
Delete a category from the Thinkific site.
Inputs: category_id (required).
delete_couponC
Delete a coupon.
Inputs: coupon_id (required).
delete_groupC
Delete a group from the Thinkific site.
Inputs: group_id (required).
delete_instructorB
Delete an instructor profile.
Inputs: instructor_id (required).
delete_promotionC
Delete a promotion.
Inputs: promotion_id (required).
delete_site_scriptC
Delete a site script.
Inputs: script_id (required).
delete_userC
Delete a user from the Thinkific site.
Inputs: user_id (required).
deny_publish_requestC
Deny a product publish request.
Inputs: request_id (required), reason.
get_bundleC
Get detailed information about a specific bundle by ID.
Inputs: bundle_id (required).
get_categoryC
Get detailed information about a specific category by ID.
Inputs: category_id (required).
get_chapterB
Get detailed information about a specific chapter by ID.
Inputs: chapter_id (required).
get_contentC
Get detailed information about a specific content/lesson by ID.
Inputs: content_id (required).
get_couponB
Get detailed information about a specific coupon by ID.
Inputs: coupon_id (required).
get_courseC
Get detailed information about a specific course by ID.
Inputs: course_id (required).
get_course_reviewC
Get a specific course review by ID.
Inputs: review_id (required).
get_enrollmentB
Get detailed information about a specific enrollment by ID.
Inputs: id (required).
get_groupB
Get detailed information about a specific group by ID.
Inputs: group_id (required).
get_instructorC
Get detailed information about a specific instructor by ID.
Inputs: instructor_id (required).
get_orderB
Get detailed information about a specific order by ID.
Inputs: order_id (required).
get_performance_metricsB
Get performance metrics and statistics for API calls, cache hit rates, and tool execution times. Use this to monitor and optimize MCP server performance.
Inputs: reset.
get_productC
Get detailed information about a specific product by ID.
Inputs: product_id (required).
get_promotionC
Get detailed information about a specific promotion by ID.
Inputs: promotion_id (required).
get_promotion_by_couponB
Look up a promotion by coupon code.
Inputs: coupon_code (required).
get_publish_requestC
Get a specific product publish request by ID.
Inputs: request_id (required).
get_site_infoB
Get overview information about the connected Thinkific site by fetching course and user counts.
Inputs: no named parameters.
get_site_scriptB
Get a specific site script by ID.
Inputs: script_id (required).
get_userC
Get detailed information about a specific user by ID.
Inputs: user_id (required).
gql_bulk_add_users_to_groupsC
Bulk add multiple users to multiple groups (GraphQL).
Inputs: userIds (required), groupIds (required).
gql_bulk_remove_users_from_groupsC
Bulk remove multiple users from multiple groups (GraphQL).
Inputs: userIds (required), groupIds (required).
gql_bundleC
Returns a Bundle by ID (GraphQL).
Inputs: id (required).
gql_categoryC
Returns a Category by ID (GraphQL).
Inputs: id (required).
gql_chapterC
Returns a Chapter by ID (GraphQL).
Inputs: id (required).
gql_communityC
Find a community by ID (GraphQL).
Inputs: id (required).
gql_community_userB
Find a community user by ID (GraphQL). Optionally filter by communityId or userId.
Inputs: id, communityId, userId.
gql_courseC
Returns a Course by ID (GraphQL).
Inputs: id (required).
gql_course_by_slugC
Returns a Course by slug (GraphQL).
Inputs: slug (required).
gql_create_postC
Create a community post in a space (GraphQL). Note: CreatePostInput uses 'content' for the body.
Inputs: spaceId (required), title (required), body.
gql_follow_postC
Follow a post to receive notifications (GraphQL).
Inputs: postId (required).
gql_groupC
Returns a Group by ID (GraphQL).
Inputs: id (required).
gql_lessonC
Returns a Lesson by ID (GraphQL).
Inputs: id (required).
gql_mark_lesson_incompleteC
Mark a lesson as incomplete for a user (GraphQL).
Inputs: lessonId (required).
gql_meB
Returns the current authenticated user (GraphQL).
Inputs: no named parameters.
gql_move_postC
Move a post to a different space (GraphQL).
Inputs: postId (required), spaceId (required).
gql_pin_postC
Pin a post in its space (GraphQL).
Inputs: postId (required).
gql_postC
Find a post or reply by ID (GraphQL).
Inputs: id (required).
gql_productC
Returns a Product by ID (GraphQL).
Inputs: id (required).
gql_react_to_postB
React to a post with an emoji reaction (GraphQL). Valid reactions: EYES, HEART_EYES, JOY, LIKE, OPEN_MOUTH, PENSIVE, TADA, WAVE.
Inputs: postId (required), reaction (required).
gql_reply_to_postC
Reply to a post (GraphQL). Note: uses 'content' for the body and 'parentId' for the post ID.
Inputs: postId (required), body (required).
gql_siteB
Returns site information for the connected Thinkific site (GraphQL).
Inputs: no named parameters.
gql_spaceC
Find a space by ID (GraphQL).
Inputs: id (required).
gql_unfollow_postC
Unfollow a post (GraphQL).
Inputs: postId (required).
gql_unpin_postC
Unpin a post (GraphQL).
Inputs: postId (required).
gql_update_assignment_submissionC
Update the status of an assignment submission (GraphQL). Valid statuses: APPROVED, PENDING, REJECTED.
Inputs: submissionId (required), status (required), message.
gql_update_postC
Update a post's title and/or content (GraphQL).
Inputs: postId (required), title, body.
gql_update_productC
Update product attributes (GraphQL). Valid statuses: DRAFT, PENDING_APPROVAL, PRESELL, PUBLISHED.
Inputs: productId (required), name, description, slug, +4 more.
gql_userB
Returns a User by their global ID (gid) (GraphQL).
Inputs: id (required).
gql_user_by_emailC
Returns a User by email address (GraphQL).
Inputs: email (required).
gql_view_lessonC
Record a lesson view for a user (GraphQL).
Inputs: lessonId (required).
list_bundle_coursesC
List courses within a specific bundle.
Inputs: bundle_id (required), page, limit.
list_bundle_enrollmentsB
List enrollments for a specific bundle.
Inputs: bundle_id (required), page, limit.
list_bundlesC
List course bundles on the Thinkific site.
Inputs: page, limit.
list_categoriesB
List course categories.
Inputs: page, limit.
list_category_productsC
List products in a specific category.
Inputs: category_id (required), page, limit.
list_chaptersC
List chapters (sections) within a course.
Inputs: course_id (required), page, limit.
list_contentsC
List content/lessons within a chapter.
Inputs: chapter_id (required), page, limit.
list_couponsB
List coupons for a promotion. Thinkific coupons belong to promotions.
Inputs: promotion_id (required), page, limit.
list_course_reviewsC
List course reviews, optionally filtered by course.
Inputs: course_id, page, limit.
list_coursesB
List courses on the Thinkific site with pagination.
Inputs: page, limit.
list_custom_profile_fieldsC
List custom profile field definitions for the site.
Inputs: page, limit.
list_enrollmentsC
List enrollments with optional filtering by user or course.
Inputs: page, limit, query_user_id, query_course_id, +1 more.
list_group_analystsB
List analysts (managers) for a group.
Inputs: group_id (required), page, limit.
list_groupsC
List groups on the Thinkific site.
Inputs: page, limit.
list_instructorsB
List instructors on the Thinkific site.
Inputs: page, limit.
list_ordersC
List orders with optional filtering.
Inputs: page, limit, query_user_id, query_email.
list_productsC
List products available on the Thinkific site.
Inputs: page, limit.
list_promotionsB
List promotions on the Thinkific site.
Inputs: page, limit.
list_publish_requestsC
List product publish requests.
Inputs: page, limit.
list_site_scriptsC
List all site scripts on the Thinkific site.
Inputs: page, limit.
list_usersC
List all users/students on the Thinkific site.
Inputs: page, limit.
purchase_external_orderC
Record a purchase transaction for an external order.
Inputs: order_id (required), amount_cents (required).
refund_external_orderC
Refund an external order.
Inputs: order_id (required), amount_cents.
remove_group_analystC
Remove a user as an analyst from a group.
Inputs: group_id (required), user_id (required).
remove_products_from_categoryC
Remove products from a category (collection membership).
Inputs: category_id (required), product_ids (required).
search_usersB
Search for users by email address. The Thinkific API filters users by exact or partial email match.
Inputs: query (required), page, limit.
update_bundle_enrollmentC
Update a bundle enrollment (e.g. change expiry, free trial status).
Inputs: bundle_id (required), user_id (required), activated_at, expiry_date, +1 more.
update_categoryC
Update an existing category.
Inputs: category_id (required), name, description.
update_couponC
Update an existing coupon.
Inputs: coupon_id (required), code, note, quantity, +1 more.
update_enrollmentC
Update an enrollment (e.g. change expiry date, mark completed, set free trial).
Inputs: id (required), activated_at, expiry_date, is_free_trial, +1 more.
update_instructorC
Update an instructor's profile.
Inputs: instructor_id (required), first_name, last_name, email, +3 more.
update_promotionC
Update an existing promotion.
Inputs: promotion_id (required), name, description, discount_type, +4 more.
update_site_scriptC
Update an existing site script.
Inputs: script_id (required), name, content, location, +1 more.
update_userC
Update an existing user's details.
Inputs: user_id (required), first_name, last_name, email, +3 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 109 tools
Many tools overlap: gql_* tools duplicate REST equivalents (get_product vs gql_product, get_bundle vs gql_bundle), and there are multiple membership tools (add_user_to_group, create_enrollment, create_bundle_enrollment) whose boundaries are unclear. Promotion/coupon creation is also easy to confuse.
Most REST tools follow a consistent verb_noun pattern (create_, list_, get_, update_, delete_). However, the 20 GraphQL tools use a separate gql_ prefix with varying verbs (gql_community, gql_create_post, gql_bulk_add_users_to_groups), creating two naming conventions. Within each group, naming is fairly predictable.
109 tools is excessive and will overwhelm agents. While the domain is broad, many tools are redundant (gql_* duplicates REST endpoints) and could be consolidated or removed. The sheer count makes selection and discovery difficult.
The surface covers CRUD for many entities (users, categories, coupons, groups, instructors) and community operations via GraphQL. However, core educational workflows are incomplete: there are no create/update/delete operations for courses, chapters, contents, or bundles, and no review moderation tools. This is a notable gap given the platform's purpose.
Maintenance
Related MCP Connectors
Connect AI assistants to Edusign attendance, courses, learners, documents, and API docs via OAuth.
Connect AI agents to 1000+ apps with managed authentication and tool-calling.
Enables AI assistants to retrieve event data and execute event management operations in Nunify.
Connect AI assistants to JustRoadmap to list, read and update workspaces, roadmaps, lanes and items. OAuth sign-in with read-only or read-and-change access per workspace. No delete tools.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with Canvas LMS through 25 comprehensive tools. Supports course management, assignments, grades, messaging, calendar events, and file access through natural language.14-
- AlicenseBqualityBmaintenanceEnables AI agents to interact with the Shopmonkey REST API to manage shop management data including work orders, customers, vehicles, and inventory. It provides 33 tools across 9 resource groups with built-in support for rate limiting, concurrency control, and multi-location management.693MIT
- AlicenseCqualityCmaintenanceProvides AI assistants with direct access to Autotask PSA for MSP operations. Enables natural language interaction for ticket management, time logging, company lookups, project tracking, and billing review through 39 comprehensive tools.100Apache 2.0
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to seamlessly interact with the Teachable API, managing courses, users, enrollments, progress tracking, and more.6 npmMIT