Pricing

Rating

Developer

Actor stats

Categories

Share

Mattermost Message Scraper - Export Chat History from Self-Hosted or Cloud

Export messages from any Mattermost workspace — both self-hosted instances and Mattermost Cloud. Connect with your instance URL and a personal access token to scrape teams, channels, and posts. Supports filtering by team name, channel name, date range, and direct messages. Returns 23 fields per message including team and channel context, author, message body (plain Markdown), reactions, and file attachment IDs.

post_message is stored as plain Markdown text, which makes it directly usable for Confluence or Notion imports, RAG pipeline ingestion, or knowledge base extraction without additional parsing.

What does the Mattermost scraper do?

It authenticates to the Mattermost REST API v4 using your personal access token, enumerates teams and channels accessible to that user, and paginates through posts in each channel. Usernames are resolved from a local cache to minimize API calls. The default API rate limit on self-hosted Mattermost is generous for authenticated users — typically 200+ requests per second.

What data does it extract?

Each record represents one Mattermost post:

Sample output record

{
"instance_url":"https://community.mattermost.com",
"team_display_name":"Contributors",
"channel_display_name":"Town Square",
"channel_type":"O",
"post_id":"3yd1q7gcrinbdmdq5qmnggd4xy",
"post_root_id":"",
"post_create_at":1748063442000,
"post_user_username":"john.doe",
"post_message":"Has anyone seen the new API docs? The pagination endpoint changed.",
"post_type":"",
"post_reactions":"[{\"emoji_name\":\"thumbsup\",\"user_id\":\"abc123\",\"create_at\":1748063500000}]",
"post_file_ids":"[]"
}

How to use it

Generating a personal access token

1. Log in to your Mattermost instance
2. Go to Account Settings → Security → Personal Access Tokens
3. Click Create Token, give it a description, and copy the token

The path may vary slightly between Mattermost versions and UI themes. Administrators can also generate tokens from the Admin Panel → Users panel for any user account.

Example input

{
"instanceUrl":"https://mattermost.yourcompany.com",
"accessToken":"your-personal-access-token",
"teamNames":["engineering"],
"channelNames":["general","incidents"],
"sinceDate":"2024-01-01",
"maxItems":5000
}

Use cases

• Compliance archival — export message history for legal hold or regulatory retention requirements in enterprise and government Mattermost deployments
• Platform migration — export messages to move to Slack, Microsoft Teams, or a custom data warehouse
• Knowledge base export — post_message is plain Markdown, so channel history exports directly to Confluence, Notion, or any RAG pipeline without additional parsing
• Incident retrospectives — extract incident channel history for post-mortems, filtered by date range
• Communication analytics — analyze team communication patterns, channel activity, and response times across channels

FAQ

Does this work with Mattermost Cloud? Yes. Set instanceUrl to your cloud workspace URL (e.g. https://yourteam.cloud.mattermost.com). The REST API v4 is identical between self-hosted and cloud.

What permissions does the token need? A standard personal access token with the authenticated user's default permissions is sufficient. The actor only reads data the token's user can access — private channels and DMs are included only if the user is a member.

How do I handle very large workspaces? Set maxItems to limit the run, then resume by setting sinceDate to the date of the last run. The actor pages through channels in batches of 200 posts per API request.

Output is available in JSON, CSV, and Excel via the Apify dataset export panel.