Motimate Public API MCP Server: User & Technical Guide

This guide details the Model Context Protocol (MCP) server for Motimate’s Public API v2. It allows users to query Motimate data using natural language directly within Claude Desktop 🤖🪄
 

1. Executive Summary & Capabilities

The Motimate MCP Server creates a read-only bridge between Claude Desktop and Motimate data using the Public API v2.

• Read Only Coverage: 
  Supports all GET endpoints in Public API v2 (no write/mutation support).
   

• Natural Language Queries: 
  Enables custom reporting and data analysis via direct prompting.
   

• Authentication Model: 
  Uses personal access tokens scoped to specific users (not shared org-level API keys).
   

• Token Expiry: 
  Personal access tokens expire every 7 days by default.

Example Prompts

• "Show me users who haven't completed the compliance course."

• "What's our most active group this month?"

• "List all published Motis with no assignments."

2. Technical Requirements

The following requirements apply for the use of the MCP server:

• The MCP Server must be enabled for your MotiSpace.
  - Support can help with this -
   

• You must be using v2 of our Public API
  - Support can help you upgrade if necessar

3. Setup Guide

Setup step 1: Generate a Personal Access Token

Requirement: This step must be performed by an Organisation Admin. If the end-user (e.g., an analyst) is not an admin, an admin must generate and share the token securely.

1. Log in to MotiSpace.
    

2. Navigate to Organisation Settings --> Tokens (sidebar).
    

3. Click Generate Token (naming the token is optional).
    

4. Copy the token immediately. It will only be shown in full once.

Setup step 2: Install the MCP Extension in Claude Desktop

1. Request the extension file (motimate-public-api-mcp-0.1.2.zip) from Support. Upon receiving it, simply unzip it to extract the .mcpb file.
    

2. Open Claude Desktop.
    

3. Navigate to Settings --> Extensions.
    

4. Drag and drop the .mcpb file into the Claude Desktop window.
    

5. Fill in the required configuration fields:

6. Toggle the extension to Enabled.

Contact our Support team should you have any questions or experience any difficulty using the Motimate MCP.