create_note

Save a note (a ‘posta’) for the current user to pick up later: an idea, a pending task, or where some work was left. Use it when the user asks to remember, note down, or leave something for later. Write it so it makes sense without this conversation: what it is, where things stand, and the next step. Write it in the user’s language. When working in a git repository, set project to the repository folder name and add repo, branch and files to refs. Never include passwords, API keys, tokens or customer data.

Annotations: readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false.

Input

string

required

Short title shown in the inbox. 1 to 80 characters; line breaks become spaces.

string

The first action when picking this up. Up to 1,000 characters.

string

What it is and where things stand. Up to 8,000 characters.

object[]

Up to 20 inert references. LePosta never opens them.

Show properties

string

required

One of repo, branch, commit, file, url, other.

string

required

For example acme/web, feat/sessions or src/api/sessions.ts. Up to 500 characters.

string

For files: a line or a range, like 12 or 12-40.

string

Project name; in a git repository, the repository folder name. Stored trimmed and lowercase. Up to 100 characters.

object

default:"{\"mode\": \"next_open\"}"

When the note shows up. See Lifecycle.

Show properties

string

required

One of now, next_open, at, project_open. project_open requires project.

string

Required with mode: "at", not allowed otherwise. ISO 8601 with UTC offset, in the user’s local time, in the future and at most 180 days ahead. Example: 2026-10-22T09:00:00-03:00.

Example

{
  "title": "Review the tenant migration",
  "next_step": "Run the dry-run script against staging and compare row counts.",
  "project": "posta-mcp",
  "refs": [
    { "type": "repo", "value": "acme/platform" },
    { "type": "file", "value": "scripts/migrate-tenants.ts" }
  ],
  "surface": { "mode": "at", "at": "2026-10-22T09:00:00-03:00" }
}

Saved posta 01M5F4D1NEATEFTXG8ZVFN8KKY "Review the tenant migration". It will show up on 2026-10-22 09:00 -03:00.

The last sentence depends on the mode:

Mode	Result ends with
`next_open`	`It will show up the next time you open your computer or Claude Code.`
`now`	`It will show up right away.`
`at`	`It will show up on <date in your time zone>.`
`project_open`	`It will show up the next time you open <project>.`

Errors

Field limits, dates, a missing project for project_open, detected secrets, the hourly limit and a full inbox. See Errors.

MCP server

MCP tools

REST API

Input

Example

Errors

​Input

​Example

​Errors

Input

Example

Errors