# add_friend

**Add a friend**

Connect with another user by name or @handle — sends a friend request (or, if they already requested me, accepts it). Ask the user to pick if several people match.

- **Category:** People & branches
- **Access:** mutating (changes state)
- **Renders a UI card:** no
- **Returns:** The result of the friend request — sent, or now friends.

## Parameters

- `name` (string, required) — Who to connect with — a name or @handle, e.g. "Andrew".
- `targetUserId` (string, optional) — The exact user id, when disambiguating after multiple matches.

## Connection

This is a tool on the Bonzai MCP server (`https://mcp.bonzai.me`). Connect any MCP
client and your agent calls it on your behalf. See https://bonzai.me/connect to connect, and
https://bonzai.me/docs for the full picture.

## Related recipes

- [The Scout](https://bonzai.me/cookbook/the-scout)

---

Full tool reference: https://bonzai.me/docs/tools · AI overview: https://bonzai.me/llms.txt