Skip to content

Installation

Copy .env.template to .env and fill in:

  • SLACK_BOT_TOKEN
  • SLACK_APP_TOKEN
  • OPENAI_API_KEY
  • PORT + TRANSPORT (for Google Calendar MCP)
  • DATABASE_URL
  • Optional (durable timeboxing preference memory in Notion):
  • NOTION_TOKEN
  • NOTION_TIMEBOXING_PARENT_PAGE_ID

Start services with Docker Compose:

docker compose up -d --build slack-bot calendar-mcp

Optional services: - Notion MCP: docker compose --profile notion up -d notion-mcp - TickTick MCP: docker compose --profile ticktick up -d ticktick-mcp

Using Timeboxing in Slack

  • In a DM with the bot, ask for a schedule: timebox tomorrow / plan tomorrow with time blocks.
  • In any thread/channel, you can force routing with /ff-focus timeboxing_agent, then send your request in that thread.