semrush-cli

projects

Existing projects and folder access, with pagination.

semrush projects --help

MCP tool: projects.

Option	Type	Default	Description
`--limit`	integer	`15`
`--offset`	integer	`0`
`--filters`	object		Project list web filter object

folders

Accessible project folders.

semrush folders --help

MCP tool: folders.

project-create

Create a project, optionally with a website. Does not start tools or share it.

semrush project-create --help

MCP tool: project_create.

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

Option	Type	Default	Description
`--name`	string		Required. Project name, up to 255 characters. The web UI restricts punctuation.
`--domain`	string		Domain or subdomain, without protocol or path.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.

project-get

Read one project by its current web folder ID.

semrush project-get --help

MCP tool: project_get.

Option	Type	Default	Description
`--folder-id`	string		Required. Current web project folder ID, as a decimal string.

project-update

Rename a project or add its first domain. Existing domains cannot be changed.

semrush project-update --help

MCP tool: project_update.

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

Option	Type	Default	Description
`--folder-id`	string		Required. Current web project folder ID, as a decimal string.
`--name`	string		Project name, up to 255 characters. The web UI restricts punctuation.
`--domain`	string		Domain or subdomain, without protocol or path.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.

project-delete

Permanently delete a project and its attached tool data.

semrush project-delete --help

MCP tool: project_delete.

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

Option	Type	Default	Description
`--folder-id`	string		Required. Current web project folder ID, as a decimal string.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.

project-leave

Leave a shared project.

semrush project-leave --help

MCP tool: project_leave.

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

Option	Type	Default	Description
`--folder-id`	string		Required. Current web project folder ID, as a decimal string.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.

project-limits

Read project creation limits.

semrush project-limits --help

MCP tool: project_limits.

project-tags

Read available project tags.

semrush project-tags --help

MCP tool: project_tags.

project-set-tags

Replace project tags. An empty array removes all its tags.

semrush project-set-tags --help

MCP tool: project_set_tags.

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

Option	Type	Default	Description
`--folder-id`	string		Required. Current web project folder ID, as a decimal string.
`--tags`	array		Required.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.

project-check-domain

Check website information before creating a project.

semrush project-check-domain --help

MCP tool: project_check_domain.

Option	Type	Default	Description
`--domain`	string		Required. Domain or subdomain, without protocol or path.

project-pin

Pin or unpin a project on the dashboard.

semrush project-pin --help

MCP tool: project_pin.

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

Option	Type	Default	Description
`--folder-id`	string		Required. Current web project folder ID, as a decimal string.
`--pinned`	boolean		Required.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.

project-toolkits

Read SEO, AI, local, social, advertising and content toolkit status.

semrush project-toolkits --help

MCP tool: project_toolkits.

Option	Type	Default	Description
`--folder-ids`	array		Required.
`--with-promo`	boolean	`false`

project-tools

Read project dashboard metrics. Tool IDs match the web dashboard.

semrush project-tools --help

MCP tool: project_tools.

Option	Type	Default	Description
`--folder-id`	string		Required. Current web project folder ID, as a decimal string.
`--tools`	array		Required.

project-enable-seo

Create the SEO project associated with an existing web project. Uses project allowance.

semrush project-enable-seo --help

MCP tool: project_enable_seo.

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

Option	Type	Default	Description
`--folder-id`	string		Required. Current web project folder ID, as a decimal string.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.

project-seo-auto-setup

Start automatic SEO setup, including Site Audit and Position Tracking. Uses account allowances.

semrush project-seo-auto-setup --help

MCP tool: project_seo_auto_setup.

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

Option	Type	Default	Description
`--folder-id`	string		Required. Current web project folder ID, as a decimal string.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.

project-shares

Read a project's shared access, including exact share IDs and roles.

semrush project-shares --help

MCP tool: project_shares.

Option	Type	Default	Description
`--folder-id`	string		Required. Current web project folder ID, as a decimal string.

Grant project access and send sharing notifications to the specified email addresses.

semrush project-share --help

MCP tool: project_share.

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

Option	Type	Default	Description
`--folder-id`	string		Required. Current web project folder ID, as a decimal string.
`--emails`	array		Required. Recipients who will receive access and sharing notifications.
`--role`	string		Required. Explicit permission for every selected share. Values: `"viewer"`, `"editor"`.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.

Change viewer/editor permissions for existing project shares.

semrush project-share-set-role --help

MCP tool: project_share_set_role.

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

Option	Type	Default	Description
`--share-ids`	array		Required. Exact share_id strings from project-shares, not project folder IDs.
`--role`	string		Required. Explicit permission for every selected share. Values: `"viewer"`, `"editor"`.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.

Revoke existing project shares and remove the recipients' access.

semrush project-share-revoke --help

MCP tool: project_share_revoke.

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

Option	Type	Default	Description
`--share-ids`	array		Required. Exact share_id strings from project-shares, not project folder IDs.
`--confirm`	boolean	`false`	Confirm this account mutation.
`--dry-run`	boolean	`false`	Print the request without sending it.

Projects

projects

folders

project-create

project-get

project-update

project-delete

project-leave

project-limits

project-tags

project-set-tags

project-check-domain

project-pin

project-toolkits

project-tools

project-enable-seo

project-seo-auto-setup

project-shares

On this page

Projects

projectsCopy Anchor Link

foldersCopy Anchor Link

project-createCopy Anchor Link

project-getCopy Anchor Link

project-updateCopy Anchor Link

project-deleteCopy Anchor Link

project-leaveCopy Anchor Link

project-limitsCopy Anchor Link

project-tagsCopy Anchor Link

project-set-tagsCopy Anchor Link

project-check-domainCopy Anchor Link

project-pinCopy Anchor Link

project-toolkitsCopy Anchor Link

project-toolsCopy Anchor Link

project-enable-seoCopy Anchor Link

project-seo-auto-setupCopy Anchor Link

project-sharesCopy Anchor Link

project-shareCopy Anchor Link

project-share-set-roleCopy Anchor Link

project-share-revokeCopy Anchor Link

On this page

projects

folders

project-create

project-get

project-update

project-delete

project-leave

project-limits

project-tags

project-set-tags

project-check-domain

project-pin

project-toolkits

project-tools

project-enable-seo

project-seo-auto-setup

project-shares

project-share

project-share-set-role

project-share-revoke