# Yahoo Mail, for your agent

> Let Muse, Claude or ChatGPT search, read and answer your Yahoo Mail with an app password, never your Yahoo password. About five minutes to set up.

muse.space wrote this guide, and "we" in it means muse.space. muse.space is an independent project. It is not affiliated with Apple, Meta or any other company whose products it works with.

Your agent searches and reads your Yahoo Mail, attachments included, and drafts, replies and sends once you turn writing on. Yahoo makes a separate app password for this, so your own password stays yours.

Start here: [Connect Yahoo Mail](https://muse.space/signup?next=%2Fapp%2Fconnectors%2Fnew%2Fyahoo). This guide as a web page: https://muse.space/guides/yahoo-mail

## What your agent can do

Each is a tool your agent calls by name. Read tools are on from the start; write tools wait for your switch.

### Mail tools

- `mail.search` (read): **Search mail.** Search one folder by sender, recipient, subject, text, date or flags, newest first, without bodies; while code and link hiding is on, terms with digits or URL punctuation miss very recent mail.
- `mail.read` (read): **Read a message.** Read one message as headers, plain body text and attachment details, with one-time codes and reset links removed.
- `mail.read_attachment` (read): **Read an attachment.** Read one attachment of a message: the text of a PDF, Office or text file, or a picture as an image, with one-time codes and reset links removed.
- `mail.list_folders` (read): **List folders.** List the folders of the mailbox with their role, message count and unread count.
- `mail.draft` (write): **Save a draft.** Save a draft in the Drafts folder for a person to review, without sending anything.
- `mail.reply` (write): **Reply to a message.** Send a reply to a message now, in the same thread, to its sender or to everyone on it.
- `mail.send` (write): **Send a message.** Send a new plain text message from the mailbox now, within its daily send limit and recipient rules.
- `mail.move_flag` (write): **Move or flag messages.** Move up to 50 messages to another folder, or mark them read, unread, flagged or unflagged, with at least one change given.
- `mail.archive` (write): **Archive messages.** Move up to 50 messages out of their folder into the Archive of this mailbox, or into All Mail on Gmail; nothing is erased.
- `mail.delete` (write): **Delete messages.** Move up to 50 messages to the Trash folder of this mailbox, from which a person can restore them; nothing is erased.

## Three steps, about five minutes

### 1. Make an app password at Yahoo

On Yahoo’s [Account Security](https://login.yahoo.com/account/security) page, choose **Generate app password** and name it `muse.space`. Sixteen letters. The spaces Yahoo shows are not part of it.

[Open Yahoo account security](https://login.yahoo.com/account/security)

### 2. Add it to muse.space

[Create an account](https://muse.space/signup?next=%2Fapp%2Fconnectors%2Fnew%2Fyahoo) and you land on the Yahoo Mail form. Paste the password there with your Yahoo Mail address, and we check it with Yahoo before anything is saved.

### 3. Connect your agent

Each agent has a short guide of its own. None of them ever sees the password.

- [Muse](https://muse.space/guides/muse.md): Give Muse your iCloud Mail, Calendar and Contacts without giving it the password. About five minutes from your phone, and free for up to 3 connectors.
- [Claude](https://muse.space/guides/claude.md): Add iCloud Mail, Calendar and Contacts to Claude as a custom connector. Claude signs in, you choose what it may use, and it never sees the password.
- [ChatGPT](https://muse.space/guides/chatgpt.md): Add iCloud Mail, Calendar and Contacts to ChatGPT with developer mode. ChatGPT signs in, you choose what it may use, and it never sees the password.
- [Claude Code](https://muse.space/guides/claude-code.md): One command adds muse.space to Claude Code. Sign in once, and it can search your iCloud Mail, check your calendar and find contacts, without the password.

## Fair things to ask first

### Is this allowed by Yahoo?

Yes. App passwords are Yahoo’s own way for other mail apps to sign in, and you can delete ours in your Yahoo account whenever you like.

### Does it work with Yahoo Calendar?

Not yet. We know where Yahoo keeps calendars, and will offer them once we have tried them properly.

### Do you keep my mail?

No. A message passes through our servers in memory for the length of the call, and is never saved or logged. The one thing kept is a short notice that new mail arrived, until your agent has it: the [security page](https://muse.space/security) lists exactly what it holds.

### What does it cost?

Nothing for up to 3 connectors, and a password counts once, however many connectors it opens. Personal, for everything more, is $5 a month or $48 a year. It is not on sale yet, and until it is we give it with codes.

## Other guides

- [Other mailboxes](https://muse.space/guides/other-mailboxes.md): Connect Fastmail, Zoho Mail, Gmail or any mailbox that speaks IMAP to Muse, Claude or ChatGPT with an app password. Your agent never sees it.
- [Muse](https://muse.space/guides/muse.md): Give Muse your iCloud Mail, Calendar and Contacts without giving it the password. About five minutes from your phone, and free for up to 3 connectors.
- [Claude](https://muse.space/guides/claude.md): Add iCloud Mail, Calendar and Contacts to Claude as a custom connector. Claude signs in, you choose what it may use, and it never sees the password.
- [ChatGPT](https://muse.space/guides/chatgpt.md): Add iCloud Mail, Calendar and Contacts to ChatGPT with developer mode. ChatGPT signs in, you choose what it may use, and it never sees the password.
