Skip to main content
Glama

Timeline MCP Server

by derekalia

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
POSTY_WORKSPACEYesPath to your Posty workspace directory containing the SQLite database

Schema

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Tools

Functions exposed to the LLM to take actions

NameDescription
timeline_add_scheduled_event

Add a scheduled event to a track. IMPORTANT: 1) Use the terminal MCP tool to get the current date/time (execute_command("date")) before scheduling events to ensure correct dates. 2) ALWAYS use timeline_list_tracks first to check existing tracks - if a track with a similar name or purpose already exists, use that instead of creating a new one. If unsure whether an existing track matches your needs, ask the user for clarification before proceeding.

timeline_list_tracks

List all tracks

timeline_add_track

Create a new track for organizing timeline events. Check existing tracks with timeline_list_tracks first to avoid duplicates.

timeline_list_scheduled_events

List scheduled events with optional filtering by track, status, platform, and date range.

STATUS FILTERING:

  • 'all': Returns all events regardless of status

  • 'pending': Returns events that haven't been generated yet (contentGenerated = false)

  • 'generated': Returns events that have been generated but not posted yet (contentGenerated = true, posted = false)

  • 'posted': Returns events that have been posted (posted = true)

DATE FILTERING:

  • startDate/endDate use DATE ONLY comparison (time is ignored)

  • Format: YYYY-MM-DD or ISO 8601 datetime string

  • Example: startDate="2025-10-14" matches ALL events scheduled on Oct 14, regardless of time

  • To get events for a single day, use the same date for both startDate and endDate

EXAMPLES:

  • Get all posted events from today: { "startDate": "2025-10-14", "endDate": "2025-10-14", "status": "posted" }

  • Get all Reddit events this week: { "platform": "reddit", "startDate": "2025-10-14", "endDate": "2025-10-20" }

  • Get pending events in a specific track: { "trackId": "track-uuid", "status": "pending" }

timeline_update_scheduled_event

Update an existing scheduled event

timeline_remove_scheduled_event

Remove a scheduled event

timeline_remove_track

Remove a track and all its associated events. WARNING: This will delete all events in the track.

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/derekalia/timeline-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server