doodle top mobile

Automate Discord with Claude Cowork

Send messages to Discord channels, attach media, schedule announcements, and integrate with your bot — all from the command line or through your AI agent.

Setup Guide

Please make sure there is always a human in the loop.

doodle left mobiledoodle right mobile

Post to Discord in Seconds

Terminal

# Install the skill
npx skills add gitroomhq/postiz-agent

# Set your API key
export POSTIZ_API_KEY=your_api_key

# Find your Discord integration
postiz integrations:list

# Send a message to a Discord channel
postiz posts:create \
  -c "Hello everyone! Big announcement coming soon." \
  -s "2025-01-15T10:00:00Z" \
  --settings '{"channel":"123456789012345678"}' \
  -i "your-discord-integration-id"

Discord-Specific Features

📢

Channel Messaging

Send messages directly to any Discord channel. Target announcements, general chat, or dedicated content channels.

📎

Media Attachments

Attach images, videos, and files to your Discord messages. Share rich content with your community automatically.

Scheduled Messages

Schedule Discord messages for specific times. Perfect for announcements, event reminders, and timed content drops.

🤖

Bot Integration

Works through your Discord bot connection. Post messages as your bot to any server and channel it has access to.

💬

Community Updates

Automate recurring community updates, changelogs, and newsletters. Keep your Discord server engaged on autopilot.

📅

Multi-Channel

Post to different channels with different messages. Customize content for each channel in your Discord server.

How It Works

1

Find Your Discord Integration

List your connected accounts and grab your Discord integration ID. You can also fetch available settings to see what options are supported.

Discovery

# List all integrations
postiz integrations:list

# Filter for Discord
postiz integrations:list | jq \
  '.[] | select(.identifier=="discord")'

# Get Discord settings schema
postiz integrations:settings <discord-id>
2

Get Your Channel ID

Find the Discord channel ID where you want to post. In Discord, enable Developer Mode, then right-click the channel and copy its ID.

Channel Setup

# Enable Developer Mode in Discord:
# User Settings > Advanced > Developer Mode

# Right-click any channel > Copy Channel ID
# Example: 123456789012345678

# You can target any channel your bot
# has permission to post in
3

Create Your Message

Schedule a Discord message with your content, optional media attachments, and the target channel ID.

Message Creation

postiz posts:create \
  -c "Hey everyone! We just shipped
  a major update. Check it out!" \
  -s "2025-03-01T09:00:00Z" \
  --settings '{
    "channel": "123456789012345678"
  }' \
  -i "discord-id"

# With media attachment
VIDEO=$(postiz upload demo.mp4)
VIDEO_URL=$(echo "$VIDEO" | jq -r '.path')

postiz posts:create \
  -c "Demo of the new feature" \
  -m "$VIDEO_URL" \
  --settings '{"channel":"123456789"}' \
  -i "discord-id"

Discord Settings Reference

Every Discord message accepts these platform-specific settings via the --settings flag.

FieldTypeDescription
__typestringMust be "discord"
channelstringDiscord channel ID to post to

Common Configurations

Copy-paste these settings for common Discord messaging scenarios.

Announcement Channel Message

settings.json

{
  "channel": "123456789012345678"
}

Message with Media Attachment

Terminal

# Upload media first
IMAGE=$(postiz upload screenshot.png)
IMAGE_URL=$(echo "$IMAGE" | jq -r '.path')

# Post with attachment
postiz posts:create \
  -c "Here's a preview of what's coming next!" \
  -m "$IMAGE_URL" \
  --settings '{"channel":"123456789012345678"}' \
  -i "discord-id"

Scheduled Weekly Update

Terminal

# Schedule a weekly update for Monday morning
postiz posts:create \
  -c "Weekly Update - March 3, 2025

Here's what we shipped this week:
- Feature A: New dashboard
- Feature B: API improvements
- Bug fix: Login issue resolved

Thanks for being part of our community!" \
  -s "2025-03-03T09:00:00Z" \
  --settings '{"channel":"123456789012345678"}' \
  -i "discord-id"

Multi-Channel Posting

Terminal

# Post to announcements channel
postiz posts:create \
  -c "v2.0 is live! Check the changelog." \
  --settings '{"channel":"111111111111111111"}' \
  -i "discord-id"

# Post detailed changelog to dev channel
postiz posts:create \
  -c "v2.0 Changelog:
- Redesigned API layer
- 50% faster response times
- New webhook support" \
  --settings '{"channel":"222222222222222222"}' \
  -i "discord-id"

What is Claude Cowork?

Claude Cowork is Anthropic's agentic AI tool for knowledge workers. It runs on your desktop, connects to local files and apps like Google Drive, Gmail, and DocuSign, and completes multi-step tasks autonomously.

💻

Desktop Native

Claude Cowork runs directly on your desktop, connecting to your local files and apps. No browser or cloud setup needed to manage your social media workflow.

🔗

App Integrations

Connects to Google Drive, Gmail, DocuSign, and more. Pull content from your existing tools and publish it to social media seamlessly.

🤖

Autonomous Tasks

Schedule recurring tasks with cron jobs. Claude Cowork can send your Discord messages on a schedule without you having to ask each time.

How Postiz Works with Claude Cowork

When you install Postiz Agent globally, Claude Cowork automatically discovers it by reading the bundled SKILL.md file. This file tells Claude Cowork what commands are available, what environment variables are needed, and how to compose Discord messages with the right settings.

  • Install Postiz Agent and set your POSTIZ_API_KEY
  • Claude Cowork discovers Postiz through MCP integration
  • All Postiz commands become available as tools
  • Claude Cowork autonomously chains commands for complex workflows
  • Works seamlessly with your existing desktop apps and files

Install Postiz

# Install the Postiz skill
npx skills add gitroomhq/postiz-agent

# Set your API key
export POSTIZ_API_KEY=your_api_key

# Claude Cowork discovers Postiz
# through MCP tool integration
# and can call all commands directly

Discord Messaging with Claude Cowork

Message Claude Cowork from any platform — it reads the Postiz skill, discovers your Discord integration, and handles the entire messaging workflow autonomously.

🦀

From Any Chat App

Tell Claude Cowork what to post from you...

Send a message to Claude Cowork from your favorite chat app. It runs as a persistent daemon on your machine, so it picks up your message, discovers your Discord bot via Postiz, and sends the message to the right channel — all while you go about your day.

Claude Cowork

You: Post to Discord about our new
  feature launch, schedule for tomorrow
  at 9am

Claude Cowork: I'll handle that for you.
  1. Found your Discord integration
  2. Composing your post
  3. Scheduling for tomorrow at 9:00 AM

  Done! Your post is scheduled.
  Post ID: abc-123
🦀

Scheduled & Proactive

Claude Cowork can be asked to perfo...

Claude Cowork supports cron-based heartbeat tasks. Set up a recurring job that sends weekly updates, daily tips, or event reminders to your Discord server automatically — no manual trigger needed.

Claude Cowork Task

Tell Claude Cowork:

"Every weekday morning, check my
~/content/drafts folder for new posts
and schedule them to Discord
for noon today. Move published drafts
to ~/content/published."

Claude Cowork will autonomously:
  1. Monitor your drafts folder
  2. Read and format each post
  3. Schedule via Postiz
  4. Move files when done

Why Claude Cowork + Postiz for Discord

Claude Cowork makes Postiz a natural fit for your Discord workflow. The agent discovers all available commands and autonomously chains them together.

  • Desktop-native — no terminal or CLI knowledge needed
  • Connects to your local files to pull content for Discord posts
  • Multi-step autonomy — handles discovery, composition, and scheduling
  • Works with Google Drive, Gmail, and other desktop apps
  • Cross-post to Discord + other platforms in a single request
  • Powered by Claude — Anthropic&apos;s most capable AI model

SKILL.md (auto-discovered)

---
name: postiz
description: Social media automation
  CLI for scheduling posts across
  30+ platforms including Discord
metadata:
  claude-cowork:
    requirements:
      env:
        - POSTIZ_API_KEY
      binaries:
        - postiz
---

# Available Commands
- postiz integrations:list
- postiz integrations:settings <id>
- postiz posts:create
- postiz upload <file>
- postiz analytics:platform <id>

# Discord Settings
channel (required channel ID)

Also Works with OpenClaw

Postiz Agent works as a CLI tool with any AI agent that can execute shell commands — including OpenClaw, the open-source personal AI agent.

🦀

OpenClaw

Open-source AI agent

Claude reads the SKILL.md file to learn all available Postiz commands, then autonomously discovers your Discord integration, identifies the right channel, and sends your message with any attachments.

OpenClaw

> Send an announcement to our Discord
  #releases channel that v2.0 is live,
  attach the changelog screenshot

Claude will automatically run:
  postiz integrations:list
  postiz upload ./changelog.png
  postiz posts:create \
    -c "v2.0 is now live! Check out
      the changelog below." \
    -m "uploaded-image-url" \
    --settings '{"channel":
      "123456789012345678"}' \
    -i "discord-id"

Discord + Other Platforms

Schedule the same announcement to Discord and other platforms in a single command. Each platform gets its own settings.

Terminal

# Announce to Discord and Twitter simultaneously
postiz posts:create \
  -c "We just launched v2.0! New features, faster performance, and more." \
  -s "2025-03-01T09:00:00Z" \
  --settings '{
    "channel": "123456789012345678"
  }' \
  -i "discord-id,twitter-id"

# Batch schedule daily tips to Discord
for day in 1 2 3 4 5; do
  postiz posts:create \
    -c "Daily Tip #$day: Stay productive with automation!" \
    -s "2025-03-0${day}T10:00:00Z" \
    --settings '{"channel":"123456789012345678"}' \
    -i "discord-id"
done

Start posting to Discord

Install Postiz Agent and automate your Discord community messaging with AI-powered scheduling and publishing.

Ready to get started?

Grow your social media presence with Postiz.
Schedule, analyze, and engage with your audience.

Grow your social media presence with Postiz.