| 1 |
# go-mcp |
| 2 |
|
| 3 |
An MCP server that exposes GoingsOn's tasks and projects to an LLM pair. It lets |
| 4 |
a Claude session create and query tasks directly instead of round-tripping |
| 5 |
through the CSV import wizard. The primary consumer is the `/dellm` skill, which |
| 6 |
migrates scattered todo backlogs into GoingsOn. |
| 7 |
|
| 8 |
Built on [kberg](../../../../MNW/shared/kberg) (`ToolRegistry` + Streamable HTTP |
| 9 |
MCP server). go-mcp opens the same `goingson.db` the desktop app uses and writes |
| 10 |
through the normal repository layer, so the sync-changelog triggers fire and a |
| 11 |
running GoingsOn stays consistent. It is a peer writer, never a back door. |
| 12 |
|
| 13 |
## Run |
| 14 |
|
| 15 |
``` |
| 16 |
go-mcp [--db <path>] [--host <ip>] [--port <n>] |
| 17 |
[--grant <cap>]... | [--grant-all] [--compact] |
| 18 |
``` |
| 19 |
|
| 20 |
- `--db` defaults to the desktop app's database (`com.goingson.app`'s |
| 21 |
`app_data_dir`). The database must already exist — run GoingsOn once to create |
| 22 |
the schema and the single desktop user. |
| 23 |
- Reads (`list_projects`, `list_tasks`, `get_task`) are always callable. |
| 24 |
- Writes are refused unless their capability is granted. Grant them with |
| 25 |
`--grant go.task.bulk_import` (repeatable) or `--grant-all` for a fully-trusted |
| 26 |
local session. |
| 27 |
- `--compact` serves only the small-model-safe surface (the read tools). |
| 28 |
|
| 29 |
Default bind is `127.0.0.1:7337`; the MCP endpoint is `POST /mcp`. |
| 30 |
|
| 31 |
## Tools |
| 32 |
|
| 33 |
Read: |
| 34 |
|
| 35 |
- `list_projects` — id, name, type, status. |
| 36 |
- `list_tasks(project?, status?, tag?)` — compact task rows. |
| 37 |
- `get_task(id)` — one task with subtasks and annotations. |
| 38 |
|
| 39 |
Write (each gated on a capability id): |
| 40 |
|
| 41 |
|
| 42 |
|
| 43 |
| `create_project(name, type?, description?)` — idempotent on name | `go.project.create` | |
| 44 |
| `create_task({description, project?, tags?, due?, priority?})` | `go.task.create` | |
| 45 |
| `bulk_import_tasks([...])` — the `/dellm` primitive | `go.task.bulk_import` | |
| 46 |
| `update_task(id, fields)` — overlays only the fields you pass | `go.task.update` | |
| 47 |
| `complete_task(id)` | `go.task.complete` | |
| 48 |
|
| 49 |
`bulk_import_tasks` dedupes on a `source:` provenance tag (e.g. |
| 50 |
`source:todo.md:42`), so re-running a migration wave does not double-insert. |
| 51 |
Projects referenced by name are resolved, and created if absent. |
| 52 |
|
| 53 |
## Wiring into a Claude session |
| 54 |
|
| 55 |
Register the running server as an HTTP MCP server, then grant the capabilities |
| 56 |
`/dellm` needs: |
| 57 |
|
| 58 |
``` |
| 59 |
go-mcp --grant-all & |
| 60 |
claude mcp add --transport http go-mcp http://127.0.0.1:7337/mcp |
| 61 |
``` |
| 62 |
|
| 63 |
`/dellm` detects go-mcp among the available MCP tools and uses it for |
| 64 |
`bulk_import_tasks`; without it, the skill falls back to CSV import. |
| 65 |
|
| 66 |
## Design |
| 67 |
|
| 68 |
`_private/docs/goingson/plans/go-mcp-design.md`. |
| 69 |
|