# SendMessage Tool

> It sends a note from one agent to another one.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** SendMessage, Cross-session messaging

## Think of it like

It is like passing a note to a friend in the next room.

## Definition

The SendMessage tool lets Claude send a message to another agent. That can be a teammate in an agent team, a subagent it wants to pick up again, or one of your other Claude Code sessions. The other agent reads the message and can act on it. Messages to other sessions need Claude Code version 2.1.224 or later.

## Example

Emma has one session on the front end and one on the server. The server session sends a message saying the new field is ready to use.

## Why it matters

Agents can work as a team and hand news to each other, not only to you.

## Common mistake

Expecting a plain subagent to get a message after it has finished. You resume it by its id or name first.

## Three principles

- **Agent to agent.** Not only to you.
- **Many targets.** Teammates, helpers, sessions.
- **Lists who to reach.** With ListAgents.

## Related terms

- [ListAgents Tool](https://learn.benibix.com/term/ai/list-agents-tool)
- [Agent Tool](https://learn.benibix.com/term/ai/agent-tool)
- [Agent Teams](https://learn.benibix.com/term/ai/agent-teams)

## Taught in

- [Claude Code Subagents](https://learn.benibix.com/learn/ai-claude-code/claude-code-subagents): Claude Code, 15/16

![The main session starts subagents with the Agent tool, messages other sessions, and stops background work.](https://learn.benibix.com/diagrams/ct-agent-tools.svg)

---

Source: https://learn.benibix.com/term/ai/send-message-tool
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-17
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
