stashcat-api-mcp

MCP (Model Context Protocol) server for the Stashcat / schul.cloud messenger API.

Allows AI assistants (e.g. Claude Desktop) to interact with Stashcat: read and send messages, manage channels and conversations, browse files, and more.

Requirements

• Node.js 20+
• A Stashcat account

Installation

git clone https://github.com/dclausen01/stashcat-api-mcp.git
cd stashcat-api-mcp
npm install
npm run build

Configuration

Copy .env.example to .env and fill in your credentials:

cp .env.example .env

STASHCAT_BASE_URL=https://api.stashcat.com/
STASHCAT_EMAIL=your-email@example.com
STASHCAT_PASSWORD=your-password
STASHCAT_APP_NAME=stashcat-mcp
STASHCAT_DEVICE_ID=              # Optional; auto-generated if omitted
STASHCAT_SECURITY_PASSWORD=      # Optional; defaults to STASHCAT_PASSWORD
                                 # Enables automatic E2E message decryption

SESSION_FILE_PATH=./stashcat-session.json

The server logs in once, unlocks E2E encryption, and persists the session to SESSION_FILE_PATH. On subsequent starts it reuses the saved session and only re-authenticates when the session has expired. E2E decryption is re-unlocked automatically on each start.

Usage with Claude Desktop

Add the server to your claude_desktop_config.json:

{
  "mcpServers": {
    "stashcat": {
      "command": "node",
      "args": ["/absolute/path/to/stashcat-api-mcp/dist/index.js"],
      "env": {
        "STASHCAT_EMAIL": "your-email@example.com",
        "STASHCAT_PASSWORD": "your-password",
        "STASHCAT_BASE_URL": "https://api.stashcat.com/"
      }
    }
  }
}

Available Tools

| Tool | Description | |---|---| | get_me | Profile of the authenticated user | | get_user | Profile of a specific user | | list_companies | Companies the user belongs to | | get_company | Details of a company | | list_company_members | Members of a company | | get_all_company_members | Get all members (no pagination) | | list_managed_users | List managed users (for admins) | | list_groups | List company groups | | list_channels | Subscribed channels of a company | | search_channels | Search visible/joinable channels | | get_channel_info | Detailed info about a channel | | get_channel_members | Members of a channel | | join_channel | Join a channel | | quit_channel | Leave a channel | | create_channel | Create a new channel | | edit_channel | Edit channel settings | | delete_channel | Delete a channel permanently | | invite_users_to_channel | Invite users to a channel | | accept_channel_invite | Accept a channel invitation | | decline_channel_invite | Decline a channel invitation | | remove_user_from_channel | Remove a user from a channel | | add_channel_moderator | Grant moderator status | | remove_channel_moderator | Revoke moderator status | | set_channel_favorite | Mark/unmark channel as favorite | | enable_channel_notifications | Enable push notifications | | disable_channel_notifications | Disable push notifications | | list_conversations | All direct messages and group chats | | get_conversation | Details of a conversation | | create_conversation | Create a new encrypted conversation | | archive_conversation | Archive a conversation | | set_conversation_favorite | Mark/unmark conversation as favorite | | get_messages | Fetch messages from a channel or conversation | | send_message | Send a text message | | delete_message | Delete a message | | mark_as_read | Mark messages as read | | like_message | Like a message | | get_flagged_messages | Get flagged messages | | unlike_message | Remove like from a message | | list_likes | List users who liked a message | | flag_message | Flag a message | | unflag_message | Unflag a message | | list_files | List files and folders | | get_file_info | Metadata for a file | | get_storage_quota | Storage quota info | | rename_file | Rename a file | | delete_files | Delete one or more files | | upload_file | Upload a file to a channel/conversation/personal | | download_file | Download a file as base64 | | move_file | Move a file to another folder | | copy_file | Copy a file to another location | | create_folder | Create a new folder | | delete_folder | Delete a folder | | get_notifications | Recent notifications | | get_notification_count | Number of unread notifications | | get_account_settings | Account settings | | list_active_devices | Active devices | | change_status | Change status message | | change_password | Change account password | | deactivate_device | Deactivate an active device | | store_profile_image | Upload profile image (base64) | | reset_profile_image | Reset profile image to default | | delete_notification | Delete a specific notification | | list_events | List calendar events in a time range | | get_event_details | Details for a specific event | | create_event | Create a new calendar event | | edit_event | Edit an existing event | | delete_events | Delete calendar events | | respond_to_event | Accept/decline event invitation | | invite_to_event | Invite users to an event | | list_available_calendars | CalDAV sync URLs | | list_channels_having_events | Channels with events | | list_broadcasts | List all broadcast lists | | create_broadcast | Create a new broadcast list | | delete_broadcast | Delete a broadcast list | | rename_broadcast | Rename a broadcast list | | add_broadcast_members | Add members to a broadcast list | | remove_broadcast_members | Remove members from a broadcast list | | list_broadcast_members | List members of a broadcast list | | get_broadcast_content | Get messages from a broadcast list | | send_broadcast_message | Send a message to a broadcast list | | Polls (Surveys) | | | list_polls | List polls by constraint (created/invited/archived) | | get_poll_details | Get full poll details with questions | | create_poll | Create a new poll (as draft) | | edit_poll | Edit an existing poll | | delete_poll | Delete a poll | | publish_poll | Publish a draft poll | | archive_poll | Archive or unarchive a poll | | invite_to_poll | Invite users or channels to a poll | | list_poll_participants | List users who answered a poll | | create_poll_question | Create a question in a poll | | edit_poll_question | Edit a question | | delete_poll_question | Delete a question | | create_poll_answer | Create an answer option | | list_poll_answers | List answers with vote counts | | vote_poll | Submit votes for a question | | export_poll | Export poll results as CSV | | watch_poll | Start/stop watching a poll | | list_poll_invited_users | List users invited to a poll | | list_poll_invites | List poll invites with pagination | | edit_poll_answer | Edit an answer option | | delete_poll_answer | Delete an answer option | | Realtime | | | create_realtime_connection | Connect to Socket.io for live events | | disconnect_realtime | Disconnect from realtime | | send_typing_indicator | Send "typing..." indicator |

Building

npm run build      # compile with esbuild → dist/index.js
npm run typecheck  # TypeScript type check only
npm run clean      # remove dist/

License

MIT