Alfraid

• AI powered

• TODO list (advanced)

  • categories (house keeping, work, text friend & family)

  • timebox (5min, instant, 15min, 6h, 1d)

  • due date

Stack

• MCP - interactions via agents

• Backend -> Just save a JSON file

How To

Prerequisites

1. Install bun

   brew install oven-sh/bun/bun

2. Install deps

   bun install

Related MCP server: Todoist MCP Server

Dev / Inspect the MCP server

The easiest way to run and check if MCP server works as expected is probably to use the "official" MCP inspector. Simply run:

bun run inspect

Run config

In your MCP Host of choice, use the following config to connect to the server:

{
  "mcpServers": {
    "alfraid": {
      "command": "bun",
      "args": ["run", "/path/to/alfraid/src/index.ts"] // make sure to update the path
    }
  }
}

Then, you should be able to ask your MCP Host to create and list TODOs.

DevSteps

1. PoC

   • server MCP up

   • Connect in VSCode / Augment

2. A bit less dirty Local MCP server

   • Specify JSON file path

   • understand how MCP really do work

   • clarify and fix need for absolute path in config

3. Go Remote / Deploy

   • Maybe on CloudFlare