Turn Gmail into a REST + MCP endpoint

Writ turns the Gmail actions you already do in a browser into a callable REST endpoint your software (and your AI agents) can call.

curl -X POST https://api.usewrit.app/v1/gmail/run \
  -H "Authorization: Bearer wt_8f2c...a91" \
  -H "Content-Type: application/json" \
  -d '{ "input": { "query": "your search term" } }'

Record the Gmail task once (search a query, then read a message) and call it as a REST endpoint and an MCP tool. No backend project, no waiting on Gmail to ship an API.

1. 1
   Record the Gmail task once

   Open the recorder and search a query on Gmail in a real browser. Writ captures each step, including login and 2FA, into a reusable workflow.

2. 2
   Publish it as an endpoint

   One click turns the workflow into a callable REST endpoint at /v1/gmail/run and a matching MCP tool. Inputs become a typed schema.

3. 3
   Call it from anything

   Call Gmail from your code, a no-code tool, or an AI agent. Run it on your own machine for free, or on metered cloud.

Read the REST API docs, see what's possible on workflows, or search for another site. Free to start. See pricing.

Gmail has an API, but some workspace and label workflows are quicker to drive in the browser, and OAuth scopes can be more than a team wants.

Writ closes that gap. Record the Gmail task once (or describe it to an AI session) and publish it as a REST endpoint at /v1/gmail/run and a matching MCP tool. Writ runs on your own accounts, with your own credentials and data, on sites you are authorized to use.

Each operation below is a real Gmail action recorded into a workflow and exposed as a typed endpoint.

Returns structured fields such as message subject, sender, label, attachment: typed JSON, not raw page text.

POST your inputs, get structured output. Authenticate every call with a scoped wt_ key.

curl -X POST https://api.usewrit.app/v1/gmail/run \
  -H "Authorization: Bearer wt_8f2c...a91" \
  -H "Content-Type: application/json" \
  -d '{ "input": { "query": "your search term" } }'

import requests

r = requests.post(
    "https://api.usewrit.app/v1/gmail/run",
    headers={"Authorization": "Bearer wt_8f2c...a91"},
    json={"input": {"query": "your search term"}},
)
print(r.json()["output"])

{
  "run_id": "run_gmai_7b21",
  "status": "succeeded",
  "output": {
    "message_subject": "...",
    "sender": "...",
    "label": "..."
  }
}

The reason Gmail has no usable API is the same reason it's hard to automate. Writ handles it.

Writ signs into your own Google account through a Persona, including 2FA, and operates inside that authenticated session.

Pick whichever fits the task. All three produce the same callable workflow.

Built on the same engine as the recorder and workflows.

Monitor Gmail for new message matching a query, label count change, attachment received and fire this endpoint the instant something changes.

Monitors check as fast as every 10s (10s on Enterprise). A detected change becomes an automation trigger that runs your workflow in seconds. Monitor Gmail ▸

Build a Gmail API

Record it once, then call it from your software and your AI agents. Get started free.