Getting Started

ChatGPT integration

MoodTrue MCP

Connect ChatGPT securely to MoodTrue through our remote Model Context Protocol server. The MCP uses MoodTrue OAuth 2.1 with PKCE, applies the same privacy rules as the public API, and supports both read and write actions.

MCP endpointhttps://mcp.moodtrue.com/mcp

Available capabilities

Account and API usage, moods and statistics, privacy-aware profiles and social data, follow/unfollow, and playlist viewing or deletion.

Permission model

Every user signs in to MoodTrue and approves explicit OAuth scopes. Write tools are marked as account-changing actions and consequential actions can require confirmation.

Connect from ChatGPT

  1. In ChatGPT web, enable Developer mode under Settings → Apps → Advanced settings.
  2. Open Settings → Apps → Create and create a custom app.
  3. Enter https://mcp.moodtrue.com/mcp as the MCP server URL and choose OAuth authentication.
  4. Select Scan tools, sign in to MoodTrue, review the permissions, and choose Connect MoodTrue.
  5. After the scan, enable the read and write actions you want available, then test or publish the app for your workspace.
Plan availability: full MCP write actions are currently intended for ChatGPT Business and Enterprise/Edu workspaces. ChatGPT Pro custom MCP connections may be limited to read/fetch actions.

OAuth scopes

account:readusage:readmood:readsocial:readsocial:writeplaylists:readplaylists:writeoffline_access

Access tokens are short-lived, refresh tokens rotate on every use, and disconnecting the ChatGPT MCP developer token in MoodTrue immediately blocks further tool calls.

Loading API documentation...