Skip to content
Hoard Hoard

Agent Inbox

The inbox connector indexes a single folder used as a shared drop zone for agents and humans. It is ideal for capturing context from MCP tools (inbox_put) without wiring every agent to every data source.

How It Works

  • Files placed in the inbox folder are ingested like local files.
  • Each entry is tagged with inbox and agent.
  • Works with background sync or the file watcher.

Configuration

connectors:
  inbox:
    enabled: true
    path: ~/.hoard/inbox
    include_extensions:
      - .md
      - .txt
      - .csv
      - .json
      - .yaml
      - .rst
    chunk_max_tokens: 400
    chunk_overlap_tokens: 50

Quick Setup

Terminal window
hoard add --inbox ~/.hoard/inbox

Writing from Agents

Use the MCP inbox_put tool to drop content into the inbox:

{
  "name": "inbox_put",
  "arguments": {
    "title": "Decision log",
    "content": "We agreed to ship the MVP next week.",
    "tags": ["decision", "mvp"]
  }
}

inbox_put writes a Markdown file with a safe timestamped filename. If sync_immediately is true (or the watcher is disabled), Hoard syncs the inbox automatically.

  • sync.watcher_enabled and sync.interval_minutes control background ingestion.
  • sync.watcher_debounce_seconds controls how quickly changes are batched.

See Also