Guides / Claude Code
Set up Tagmails with Claude Code
Email a task to Claude Code running on your own Mac or Linux computer. It works in the right project and replies in the same thread.
Before you start
- Claude Code installed and signed in on the computer that should do the work. Run
claudeonce to check. - Node.js 20.16 or newer.
- A Gmail address to email from. Your first sign-in with Google creates the Tagmails account.
1. Paste one line into Claude Code
Read https://tagmails.com/skill.md and set up Tagmails.
Claude Code reads the setup skill, installs Tagmails, asks which agent and default model you want, and shows you a link. Open it, check that the page shows the same code, and continue with Google. It finishes by running tagmails doctor.
2. Add a balance
Each reply costs $0.0025 (400 per $1). Add $10 from the website when you sign in; the balance doesn't expire. The model itself runs on your own Claude plan.
3. Email your agent
Write to the address Tagmails gave you (you can choose the name before the @). A welcome email arrives first; replying to it is a good first test. Reply in a thread to continue the same Claude Code session.
What Claude Code can do
By default Tagmails runs Claude Code in auto mode inside the project folder it picked, with your own MCP servers and skills available to your emails. You can change this on the computer only, never by email:
tagmails start --claude-permission manual tagmails start --claude-permission accept-edits tagmails start --claude-permission auto
The website and email can change model defaults, but not permissions.
Models and effort
Pick a default during setup, or change it later without a restart: tagmails set --model claude-sonnet-5-5 --effort high. Any email can ask for something else in plain words ("use high effort") or on a first line such as Model: claude-sonnet-5-5. Tagmails decides this on your computer with a small Claude model under your own plan; no one else reads your email to route it.
Which project?
Tagmails picks from your recent Claude Code and Codex project folders using the name in your email, its purpose and recent work there. If it can't tell, it runs in a fresh chat folder, or asks. To be exact, write Work in /Users/you/code/site. Open a project in Claude Code once so Tagmails can see it.
If something is off
tagmails doctorchecks sign-ins, the service and your project list, and prints a fix for each problem.- No reply? The computer may be asleep (the email waits and runs when it's back), or the balance is empty.
- More in Support.
Next: what to email your agent.