Answer: To send a message between sessions, call `$.session.send({ to, text })`, setting `to` to `{ sessionId }` for another of your sessions, `{ agentId }` for a subagent or teammate, or the string address a received message came from. To observe messages, use the `session.receive` and `session.send` events, returning `next(e)` from both to pass each message through unchanged. Status: Confirmed Entry: tool/claude-code/agents-and-automation/message-between-sessions-mod Revision: 2 Digest: sha256:22021462930d799f (changes whenever the content changes) Timeline: Created: 2026-11-13T03:05:11Z Last changed: 2026-11-20T12:23:34Z (not delivered result: — → { isDelivered: false, reason }) Last verified: 2026-11-20T12:23:34Z Next check: 2026-11-21T12:23:34Z Check interval: Daily Expected change: No fixed schedule Data: Field | Value | Source | As of send call | $.session.send({ to, text }) | [1] | 2026-11-20 target for another session | { sessionId } | [1] | 2026-11-20 target for subagent or teammate | { agentId } | [1] | 2026-11-20 delivered result | { isDelivered: true } | [1] | 2026-11-20 not delivered result | { isDelivered: false, reason } | [1] | 2026-11-20 receive event | session.receive | [1] | 2026-11-20 send event | session.send | [1] | 2026-11-20 Sources: [1] Anthropic. "Use the mods API". https://code.claude.com/docs/en/plugins/mods/api.md Role: primary. Accessed: 2026-11-20T12:23:34Z Quote: "To send one, call `$.session.send({ to, text })`, which makes the same delivery the SendMessage tool makes." (Supports: send call) Quote: "**Another of your sessions**: `{ sessionId }`" (Supports: target for another session) Quote: "**A subagent or teammate**: `{ agentId }`, with an id from `$.agent.list()`" (Supports: target for subagent or teammate) Quote: "The call resolves once the message is queued, with `{ isDelivered: true }`." (Supports: delivered result) Quote: "When nothing was delivered, it resolves with `{ isDelivered: false, reason }`, and `reason` says why." (Supports: not delivered result) Quote: "`session.receive` | A message arrives for this session, before Claude reads it" (Supports: receive event) Quote: "`session.send` | A message is about to leave, from the SendMessage tool or a mod" (Supports: send event) Published: 2026-11-20T10:36:06Z Snapshot SHA-256: ca14f630f768366693cc8185a9947d443c402745f351ddfdefa3cbaed2a7883c (captured 2026-11-19T12:18:56Z) Verification: Method: Automated extraction from [1] with deepseek-flash (JSON output, thinking disabled). Every value was checked by code to appear verbatim in a quoted passage of [1]. On this check the text of [1] was unchanged since 2026-11-19T12:18:59Z, so the values verified then were kept. Cross-check: not-available at 2026-11-20T12:23:34Z. No independent second source is configured for this entry Last successful check: 2026-11-20T12:23:34Z Last attempt: 2026-11-20T12:23:34Z Notes and limitations: Extracted automatically from a single official source (section "Send and receive messages between sessions"). Related: https://latestn.com/tool/claude-code/agents-and-automation/minimal-agent-sdk-example Where can I find a minimal Claude Code Agent SDK example project to start with? https://latestn.com/tool/claude-code/agents-and-automation/missed-runs What happens to missed runs of a scheduled task in Claude Code Desktop? https://latestn.com/tool/claude-code/agents-and-automation/mod-hook-events Which events can a Claude Code mod hook into, such as tool, prompt, session, or telemetry events? https://latestn.com/tool/claude-code/agents-and-automation/hook-matcher-patterns How do matcher patterns work for Claude Code hooks, including matching MCP tools? https://latestn.com/tool/claude-code/agents-and-automation/isolate-subagents-worktrees How do I isolate subagents in separate worktrees in Claude Code? https://latestn.com/tool/claude-code/agents-and-automation/load-plugin-in-sdk How do I load a plugin in the Claude Code Agent SDK? https://latestn.com/tool/ All entries in AI tools Change log: Time | Event | Change | Source 2026-11-20T12:23:34Z | changed | not delivered result: — → { isDelivered: false, reason } | [1] 2026-11-13T03:05:11Z | added | Entry created | — Changes for this entry as a feed: https://latestn.com/tool/claude-code/agents-and-automation/message-between-sessions-mod/latest Challenge this entry: Open challenges: None How: If a value here is wrong or out of date, send what is wrong and a link to evidence. Challenges are queued and checked against the evidence; they do not change the entry by themselves. If the entry changes as a result, the change log says so. Form: https://latestn.com/dispute/tool/claude-code/agents-and-automation/message-between-sessions-mod POST: https://latestn.com/dispute/tool/claude-code/agents-and-automation/message-between-sessions-mod with claim, evidence_url, and optionally field and contact (form-encoded or JSON) GET: https://latestn.com/dispute/tool/claude-code/agents-and-automation/message-between-sessions-mod?claim={what is wrong}&evidence_url={link} How to cite: LatestN. (2026). How do I send and receive messages between sessions in Claude Code mods? Revision 2, last verified 2026-11-20T12:23:34Z. https://latestn.com/tool/claude-code/agents-and-automation/message-between-sessions-mod (accessed 2026-11-21T09:58:44Z). @misc{LatestN_tool_claude_code_agents_and_automation_message_between_sessions_mod_r2, title = {How do I send and receive messages between sessions in Claude Code mods?}, author = {{LatestN}}, year = {2026}, howpublished = {\url{https://latestn.com/tool/claude-code/agents-and-automation/message-between-sessions-mod}}, note = {Revision 2; digest sha256:22021462930d799f; last verified 2026-11-20T12:23:34Z; accessed 2026-11-21T09:58:44Z} } Reuse: License: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/) Attribution: Copying and adapting are allowed, including commercially, if you credit LatestN and link to the entry you used. Each entry ends with a ready-made citation. URL: https://latestn.com/tool/claude-code/agents-and-automation/message-between-sessions-mod