Commands

Chart notes

Commands and options for chart notes.

notes

List chart notes with native pagination, tool, category and date filters.

semrush notes --help

MCP tool: notes.

Option	Type	Default	Description
`--tools`	array
`--project-ids`	array
`--categories`	array
`--database`	string
`--datetime-from`	string		UTC ISO timestamp, for example 2026-10-15T00:00:00Z.
`--datetime-to`	string		UTC ISO timestamp, for example 2026-10-15T00:00:00Z.
`--page`	integer	`1`
`--per-page`	integer	`20`
`--descending`	boolean	`true`
`--include-hidden`	boolean	`true`
`--locale`	string	`"en"`	Values: `"en"`, `"de"`, `"es"`, `"fr"`, `"it"`, `"pt"`, `"zh"`, `"ja"`, `"tr"`, `"ko"`, `"vi"`, `"pl"`, `"sv"`, `"nl"`.

note

Read a chart note without changing its visibility.

semrush note --help

MCP tool: note.

Option	Type	Default	Description
`--note-id`	string		Required.

note-databases

Read available country databases for chart notes.

semrush note-databases --help

MCP tool: note_databases.

note-hidden-categories

Read hidden note categories for a chart context.

semrush note-hidden-categories --help

MCP tool: note_hidden_categories.

Option	Type	Default	Description
`--tool`	string		Required. Values: `"DOMAIN_OVERVIEW"`, `"ORGANIC_POSITIONS"`, `"SENSOR"`, `"POSITION_TRACKING"`, `"SEO_IDEAS"`, `"ORGANIC_TRAFFIC_INSIGHTS"`, `"BACKLINK_AUDIT"`, `"SITE_AUDIT"`.
`--project-id`	integer

note-create

Create a user note for selected chart tools.

semrush note-create --help

MCP tool: note_create.

Use --confirm to send the change or --dry-run to preview it.

Option	Type	Default	Description
`--title`	string		Required.
`--note`	string	`""`
`--datetime`	string		Required. UTC ISO timestamp, for example 2026-10-15T00:00:00Z.
`--tools`	array		Required.
`--databases`	array	`[]`
`--project-id`	integer / null	`null`	SEO project ID; null applies the note to all projects.
`--link`	string		Related HTTP(S) URL; an empty string clears it.
`--confirm`	boolean		Confirm this account change.
`--dry-run`	boolean		Preview without signing in or sending the change.

note-update

Update an owned note while preserving omitted fields.

semrush note-update --help

MCP tool: note_update.

Use --confirm to send the change or --dry-run to preview it.

Option	Type	Default	Description
`--note-id`	string		Required.
`--title`	string
`--note`	string
`--datetime`	string		UTC ISO timestamp, for example 2026-10-15T00:00:00Z.
`--tools`	array
`--databases`	array
`--project-id`	integer / null		SEO project ID; null applies the note to all projects.
`--link`	string		Related HTTP(S) URL; an empty string clears it.
`--confirm`	boolean		Confirm this account change.
`--dry-run`	boolean		Preview without signing in or sending the change.

note-delete

Delete an owned user note; published notes are protected.

semrush note-delete --help

MCP tool: note_delete.

Use --confirm to send the change or --dry-run to preview it.

Option	Type	Default	Description
`--note-id`	string		Required.
`--confirm`	boolean		Confirm this account change.
`--dry-run`	boolean		Preview without signing in or sending the change.

note-hide

Hide a note in your chart view.

semrush note-hide --help

MCP tool: note_hide.

Use --confirm to send the change or --dry-run to preview it.

Option	Type	Default	Description
`--note-id`	string		Required.
`--confirm`	boolean		Confirm this account change.
`--dry-run`	boolean		Preview without signing in or sending the change.

note-show

Show a note in your chart view.

semrush note-show --help

MCP tool: note_show.

Use --confirm to send the change or --dry-run to preview it.

Option	Type	Default	Description
`--note-id`	string		Required.
`--confirm`	boolean		Confirm this account change.
`--dry-run`	boolean		Preview without signing in or sending the change.

note-hidden-categories-set

Replace hidden categories for one chart context.

semrush note-hidden-categories-set --help

MCP tool: note_hidden_categories_set.

Use --confirm to send the change or --dry-run to preview it.

Option	Type	Default	Description
`--tool`	string		Required. Values: `"DOMAIN_OVERVIEW"`, `"ORGANIC_POSITIONS"`, `"SENSOR"`, `"POSITION_TRACKING"`, `"SEO_IDEAS"`, `"ORGANIC_TRAFFIC_INSIGHTS"`, `"BACKLINK_AUDIT"`, `"SITE_AUDIT"`.
`--project-id`	integer
`--categories`	array		Required.
`--confirm`	boolean		Confirm this account change.
`--dry-run`	boolean		Preview without signing in or sending the change.

notes-export

Export all chart notes as the native CSV file; the web export does not apply list filters.

semrush notes-export --help

MCP tool: notes_export.

Pass --output <path> to save the file. Existing files are not overwritten. MCP returns an artifact resource.

Position Tracking

Commands and options for position tracking.

Backlink Audit

Commands and options for backlink audit.

On this page

notes note note-databases note-hidden-categories note-create note-update note-delete note-hide note-show note-hidden-categories-set notes-export