discord-mcp

Delete message

discord_delete_message

Destructive

Toolset
Messages messages
Discord permissions
View Channel and Read Message HistoryManage Messages when deleting another user's message also
Context cost
264 tokens, estimated1,055 bytes of definition, divided by 4

Permanently delete one specific message. IRREVERSIBLE. Requires the View Channel and Read Message History permissions to find the message. The bot can then delete its own messages; deleting another user's message also requires the Manage Messages permission. Use discord_bulk_delete_messages to remove many at once. Discord does not record a reason for a single message delete in the audit log.

Risk and annotations

Read-onlyreadOnlyHintnoCan modify your server.
DestructivedestructiveHintyesMay perform destructive updates, so clients can ask before running it.
IdempotentidempotentHintnoRepeating the call can have an additional effect.
Open worldopenWorldHintyesInteracts with an external system: Discord.

Annotations are hints the server declares. Clients use them to decide when to ask you before a call.

Parameters

ParameterTypeRulesDescription
channel_idrequiredstring
pattern ^\d{17,20}$
ID (snowflake) of the channel or thread containing the message.
message_idrequiredstring
pattern ^\d{17,20}$
ID of the message to delete.
reasonoptionalstring
none
Optional. Not recorded: Discord keeps no audit log reason for a single message delete.

Output

This tool declares no output schema. Its description says what it returns; this page shows no example rather than invent one.

Related tools

Named in its description

Also in Messages

Raw definition (1,055 bytes)
{
  "name": "discord_delete_message",
  "description": "Permanently delete one specific message. IRREVERSIBLE. Requires the View Channel and Read Message History permissions to find the message. The bot can then delete its own messages; deleting another user's message also requires the Manage Messages permission. Use discord_bulk_delete_messages to remove many at once. Discord does not record a reason for a single message delete in the audit log.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "channel_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "ID (snowflake) of the channel or thread containing the message."
      },
      "message_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "ID of the message to delete."
      },
      "reason": {
        "description": "Optional. Not recorded: Discord keeps no audit log reason for a single message delete.",
        "type": "string"
      }
    },
    "required": [
      "channel_id",
      "message_id"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Delete message",
    "readOnlyHint": false,
    "destructiveHint": true,
    "idempotentHint": false,
    "openWorldHint": true
  }
}