README
¶
sloptools
Core MCP server for the sloppy.at product family. Provides workspace, items, artifacts, actors, mail, calendar, contacts, tasks, brain, handoffs, temp files, and canvas tools over the Model Context Protocol.
There are exactly two external agent-facing MCP servers in the sloppy stack:
sloppy=sloptools mcp-serverhelpy=helpy mcp-stdio
slopshell is the UI/runtime layer and is not an MCP server.
Docs:
docs/groupware.md— MCP tool reference and per-backend capability matrix.docs/vaults.md— brain vault config schema.
Install
Requires Go 1.24+.
go install github.com/sloppy-org/sloptools/cmd/sloptools@latest
Or from a checkout:
go build -o sloptools ./cmd/sloptools
Run
sloptools mcp-server --stdio --vault-config ~/.config/sloptools/vaults.toml
# MCP over stdio (per-agent subprocess; default)
sloptools server \
--project-dir "$HOME" \
--data-dir "$HOME/.local/share/sloppy" \
--mcp-unix-socket "$XDG_RUNTIME_DIR/sloppy/sloptools.sock"
# long-lived runtime daemon (Unix)
sloptools server \
--project-dir "$HOME" \
--data-dir "$HOME/.local/share/sloppy" \
--mcp-host 127.0.0.1 --mcp-port 9420
# long-lived runtime daemon (Windows / TCP)
Wire into coding agents
Registers sloppy with every CLI present on PATH (claude, codex, opencode,
qwen, gemini). Idempotent.
./scripts/setup-sloptools-mcp.sh
Per-tool scripts live next to it. Override defaults via SLOPTOOLS_PROJECT_DIR,
SLOPTOOLS_DATA_DIR, SLOPTOOLS_MCP_NAME.
Install as a service
Linux (systemd user)
./scripts/install-sloptools-user-unit.sh
Installs and starts sloptools-runtime.service on
$XDG_RUNTIME_DIR/sloppy/sloptools.sock with backend state in
$HOME/.local/share/sloppy.
Windows (Scheduled Task, no admin)
.\scripts\install-sloptools-windows-service.ps1
Registers a per-user Scheduled Task that starts sloptools server at logon
on 127.0.0.1:9420, with data in %LOCALAPPDATA%\sloppy, and auto-restarts
on failure. No administrator rights, no third-party tools. Runs in the
current user's interactive session.
.\scripts\install-sloptools-windows-service.ps1 -Uninstall
Override defaults with -Name, -BinaryPath, -ProjectDir, -DataDir,
-Bind, -Port.
Security
- MCP stdio: no listening socket; subprocess inherits the spawning UID.
- Runtime daemon: private Unix socket (
0700dir,0600socket) on Unix; loopback TCP on Windows. Non-loopback binds are blocked unless--unsafe-public-mcpis passed.
License
MIT. See LICENSE. Provided as-is, no warranty.
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
checkcapabilities
command
Command checkcapabilities probes the capability interfaces implemented by each enabled external account and prints a Markdown capability matrix.
|
Command checkcapabilities probes the capability interfaces implemented by each enabled external account and prints a Markdown capability matrix. |
|
sloptools
command
|
|
|
internal
|
|
|
brain/activity
Package activity builds a compact, noise-filtered activity digest from groupware (calendar events + mail) and brain git history for the time window since the previous brain night run.
|
Package activity builds a compact, noise-filtered activity digest from groupware (calendar events + mail) and brain git history for the time window since the previous brain night run. |
|
brain/audit
Package audit holds the per-stage sidecar + audit-file helpers that every brain-night pipeline (scout, sleep, future stages) writes next to the canonical report.
|
Package audit holds the per-stage sidecar + audit-file helpers that every brain-night pipeline (scout, sleep, future stages) writes next to the canonical report. |
|
brain/backend
Package backend defines a uniform Backend interface over the model backends we use.
|
Package backend defines a uniform Backend interface over the model backends we use. |
|
brain/bench
Package bench runs the brain-night model matrix benchmark.
|
Package bench runs the brain-night model matrix benchmark. |
|
brain/cleanup
Package cleanup holds deterministic post-processors that strip narration from raw model output before it is persisted as a report.
|
Package cleanup holds deterministic post-processors that strip narration from raw model output before it is persisted as a report. |
|
brain/edit
Package edit runs focused per-entity editorial passes.
|
Package edit runs focused per-entity editorial passes. |
|
brain/evidence
Package evidence maintains the append-only evidence event log that connects scout findings to judge edits.
|
Package evidence maintains the append-only evidence event log that connects scout findings to judge edits. |
|
brain/glossary
Package glossary auto-injects local-vocabulary terms into scout / folder-note / triage packets so the agent does not e.g.
|
Package glossary auto-injects local-vocabulary terms into scout / folder-note / triage packets so the agent does not e.g. |
|
brain/gtd/today
Package gtdtoday implements the closed daily list that brain.gtd.today persists per day.
|
Package gtdtoday implements the closed daily list that brain.gtd.today persists per day. |
|
brain/ledger
Package ledger maintains a per-provider, rolling-7-day record of every brain-night model call.
|
Package ledger maintains a per-provider, rolling-7-day record of every brain-night model call. |
|
brain/people
Package people derives canonical monthly journal indexes from `## Log` entries kept in `brain/people`, `brain/projects`, and `brain/topics` notes.
|
Package people derives canonical monthly journal indexes from `## Log` entries kept in `brain/people`, `brain/projects`, and `brain/topics` notes. |
|
brain/peoplebrief
Package peoplebrief assembles the read-only `brain.people.brief` payload from a person's note frontmatter, status bullets, open commitments, most recent meeting note, and most recent inbound mail message.
|
Package peoplebrief assembles the read-only `brain.people.brief` payload from a person's note frontmatter, status bullets, open commitments, most recent meeting note, and most recent inbound mail message. |
|
brain/prompts
Package prompts embeds the role-specific system prompts used by every brain-night stage.
|
Package prompts embeds the role-specific system prompts used by every brain-night stage. |
|
brain/routing
Package routing picks a Backend + Model + Reasoning per stage of the brain night.
|
Package routing picks a Backend + Model + Reasoning per stage of the brain night. |
|
brain/scout
Package scout selects stale-or-uncertain canonical entities and runs a bounded autonomous research pass over each.
|
Package scout selects stale-or-uncertain canonical entities and runs a bounded autonomous research pass over each. |
|
brain/sleep
Package sleep holds the deterministic classifier and the bulk → paid pipeline for the sleep-judge stage.
|
Package sleep holds the deterministic classifier and the bulk → paid pipeline for the sleep-judge stage. |
|
brain/sleepconv
Package sleepconv extracts user-typed prompts from interactive Claude Code and Codex CLI session logs, classifies them by sphere, and renders them (plus a deterministic entity-candidate checklist) for the sleep packet.
|
Package sleepconv extracts user-typed prompts from interactive Claude Code and Codex CLI session logs, classifies them by sphere, and renders them (plus a deterministic entity-candidate checklist) for the sleep packet. |
|
brain/textbook
Package textbook classifies brain notes against a deny-list of textbook-only topics (Wikipedia-derivable concepts with no local anchor to Christopher Albert's group or projects).
|
Package textbook classifies brain notes against a deny-list of textbook-only topics (Wikipedia-derivable concepts with no local anchor to Christopher Albert's group or projects). |
|
brain/triage
Package triage runs a fast qwen-MoE pass to rank which canonical entities need editorial attention tonight.
|
Package triage runs a fast qwen-MoE pass to rank which canonical entities need editorial attention tonight. |
|
calendar
Package calendar exposes a core Provider interface plus capability interfaces mirroring internal/email/provider.go.
|
Package calendar exposes a core Provider interface plus capability interfaces mirroring internal/email/provider.go. |
|
calendarbrief
Package calendarbrief implements the pre-meeting people-brief trigger described in issue #92.
|
Package calendarbrief implements the pre-meeting people-brief trigger described in issue #92. |
|
chat
Package chat defines provider-neutral read access to team chat systems.
|
Package chat defines provider-neutral read access to team chat systems. |
|
groupware
Package groupware owns per-account provider construction and auth-session sharing across mail, calendar, contacts, and task features.
|
Package groupware owns per-account provider construction and auth-session sharing across mail, calendar, contacts, and task features. |
|
mailboxsettings
Package mailboxsettings exposes capability interfaces for mailbox-level settings that sit alongside email/calendar/contacts but do not belong to any of them.
|
Package mailboxsettings exposes capability interfaces for mailbox-level settings that sit alongside email/calendar/contacts but do not belong to any of them. |
|
meetings
Package meetings parses MEETING_NOTES-style brain notes into structured per-person tasks with stable comment-anchored IDs.
|
Package meetings parses MEETING_NOTES-style brain notes into structured per-person tasks with stable comment-anchored IDs. |
|
meetings/kickoff
Package kickoff assembles the read-only `brain.meeting.kickoff` payload: a draft frame plus a clustered breakout grouping built from pre-meeting Zulip posts.
|
Package kickoff assembles the read-only `brain.meeting.kickoff` payload: a draft frame plus a clustered breakout grouping built from pre-meeting Zulip posts. |
|
tasks
Package tasks defines the core task-management contract and the capability interfaces that specific backends (Google Tasks, Exchange EWS, etc.) may implement on top of it.
|
Package tasks defines the core task-management contract and the capability interfaces that specific backends (Google Tasks, Exchange EWS, etc.) may implement on top of it. |
|
zulip
Package zulip is a small read-only client for the Zulip REST API.
|
Package zulip is a small read-only client for the Zulip REST API. |
|
pkg
|
|
Click to show internal directories.
Click to hide internal directories.