@@ -13,9 +13,12 @@ _Interact with [Lunatask](https://lunatask.app) using `$PREFERRED_LLM`_
[](https://api.reuse.software/info/git.secluded.site/lunatask-mcp-server)
[](https://liberapay.com/Amolith/)
-**Note:** lots of this was written by LLMs and I haven't reviewed it thoroughly
-enough to be comfortable making it more public than unlisted. Please refrain
-from sharing it around and do let me know if there are any issues.
+**Note:** I've retired this MCP server in favour of [lune], a delightful CLI _and_ MCP server for Lunatask. One tool with two interfaces. The CLI is useful for both humans and LLM agents that can run shell commands[^1], while the MCP interface is exclusively for LLM systems.
+
+[^1]: I have some great [Agent Skills] using the CLI
+
+[lune]: https://git.secluded.site/lune
+[Agent Skills]: https://git.secluded.site/agent-skills
---
@@ -56,6 +59,7 @@ This MCP server provides several tools for interacting with Lunatask:
Parses natural language dates into RFC3339 timestamps.
**Parameters:**
+
- `natural_language_date` (string, required): A natural language description of a date/time (e.g., "today at 3pm", "next Monday", "in 2 hours")
### `list_areas_and_goals`
@@ -63,6 +67,7 @@ Parses natural language dates into RFC3339 timestamps.
Lists all configured areas and their goals in Lunatask.
**Returns:**
+
- Text formatted as a list with area names and IDs, and their associated goal names and IDs
### `create_task`
@@ -70,6 +75,7 @@ Lists all configured areas and their goals in Lunatask.
Creates a new task in Lunatask.
**Parameters:**
+
- `area_id` (string, required): UUID of the area to create the task in
- `name` (string, required): Name of the task (max 100 characters)
- `goal_id` (string, optional): UUID of the goal to associate the task with
@@ -86,6 +92,7 @@ Creates a new task in Lunatask.
Updates an existing task in Lunatask.
**Parameters:**
+
- `task_id` (string, required): UUID of the task to update
- `area_id` (string, optional): UUID of the area to move the task to
- `name` (string, optional): New name for the task
@@ -103,6 +110,7 @@ Updates an existing task in Lunatask.
Deletes a task from Lunatask.
**Parameters:**
+
- `task_id` (string, required): UUID of the task to delete
### `list_habits_and_activities`
@@ -110,6 +118,7 @@ Deletes a task from Lunatask.
Lists all configured habits in Lunatask.
**Returns:**
+
- Text formatted as a list with habit names and IDs
### `track_habit_activity`
@@ -117,6 +126,7 @@ Lists all configured habits in Lunatask.
Tracks an activity for a habit in Lunatask.
**Parameters:**
+
- `habit_id` (string, required): UUID of the habit to track
- `performed_on` (string, required): RFC3339 formatted timestamp of when the habit was performed