discord-mcp

Create scheduled event

discord_create_scheduled_event

Write

Toolset
Scheduled events scheduled_events
Discord permission
Create Events
Context cost
660 tokens, estimated2,641 bytes of definition, divided by 4

Create a scheduled event. For 'VOICE'/'STAGE_INSTANCE' events provide channel_id; for 'EXTERNAL' events provide location AND scheduled_end_time. Requires the Create Events permission (Manage Events alone no longer suffices), plus View Channel and Connect in the channel for VOICE events, or Manage Channels, Mute Members and Move Members for STAGE_INSTANCE events. Returns the new event's name and ID. To change, start or cancel an existing event, use discord_edit_scheduled_event.

Risk and annotations

Read-onlyreadOnlyHintnoCan modify your server.
DestructivedestructiveHintnoDeclared non-destructive.
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
guild_idrequiredstring
pattern ^\d{17,20}$
Discord server (guild) ID (snowflake).
namerequiredstring
none
Event name (max 100 characters).
descriptionoptionalstring
none
Optional event description (max 1000 characters).
entity_typerequiredstring
one of "VOICE""STAGE_INSTANCE""EXTERNAL"
Where the event happens: 'VOICE' or 'STAGE_INSTANCE' (needs channel_id), or 'EXTERNAL' (needs location + scheduled_end_time).
scheduled_start_timerequiredstring
format date-time
pattern (288 characters)^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
Event start as an ISO 8601 datetime, e.g. '2026-06-01T20:00:00Z'. Must be in the future.
scheduled_end_timeoptionalstring
format date-time
pattern (288 characters)^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
Event end as an ISO 8601 datetime. Required for EXTERNAL events.
channel_idoptionalstring
pattern ^\d{17,20}$
Voice or stage channel ID (snowflake). Required for VOICE/STAGE_INSTANCE events.
locationoptionalstring
none
Free-text location (e.g. a URL or place). Required for EXTERNAL events.
imageoptionalstring
format uripattern ^https?://
Optional cover image URL.

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 Scheduled events

Raw definition (2,641 bytes)
{
  "name": "discord_create_scheduled_event",
  "description": "Create a scheduled event. For 'VOICE'/'STAGE_INSTANCE' events provide channel_id; for 'EXTERNAL' events provide location AND scheduled_end_time. Requires the Create Events permission (Manage Events alone no longer suffices), plus View Channel and Connect in the channel for VOICE events, or Manage Channels, Mute Members and Move Members for STAGE_INSTANCE events. Returns the new event's name and ID. To change, start or cancel an existing event, use discord_edit_scheduled_event.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "guild_id": {
        "type": "string",
        "pattern": "^\\d{17,20}$",
        "description": "Discord server (guild) ID (snowflake)."
      },
      "name": {
        "type": "string",
        "description": "Event name (max 100 characters)."
      },
      "description": {
        "description": "Optional event description (max 1000 characters).",
        "type": "string"
      },
      "entity_type": {
        "type": "string",
        "enum": [
          "VOICE",
          "STAGE_INSTANCE",
          "EXTERNAL"
        ],
        "description": "Where the event happens: 'VOICE' or 'STAGE_INSTANCE' (needs channel_id), or 'EXTERNAL' (needs location + scheduled_end_time)."
      },
      "scheduled_start_time": {
        "type": "string",
        "format": "date-time",
        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
        "description": "Event start as an ISO 8601 datetime, e.g. '2026-06-01T20:00:00Z'. Must be in the future."
      },
      "scheduled_end_time": {
        "description": "Event end as an ISO 8601 datetime. Required for EXTERNAL events.",
        "type": "string",
        "format": "date-time",
        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"
      },
      "channel_id": {
        "description": "Voice or stage channel ID (snowflake). Required for VOICE/STAGE_INSTANCE events.",
        "type": "string",
        "pattern": "^\\d{17,20}$"
      },
      "location": {
        "description": "Free-text location (e.g. a URL or place). Required for EXTERNAL events.",
        "type": "string"
      },
      "image": {
        "description": "Optional cover image URL.",
        "type": "string",
        "format": "uri",
        "pattern": "^https?://"
      }
    },
    "required": [
      "guild_id",
      "name",
      "entity_type",
      "scheduled_start_time"
    ],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Create scheduled event",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": true
  }
}