Tools reference

The hosted MCP server exposes tools that operate through normal LFG List permissions. A tool can only see and change data available to the user behind the Personal Access Token.

Connection and project tools

Tool	What it does
get_config_status	Shows non-secret MCP configuration status.
list_projects	Lists projects visible to the token owner.
get_project	Gets one project by id, name, or configured default project.
update_project	Updates basic project details such as name, icon, color, and whether new items open immediately.
set_project_features	Replaces the enabled item fields/features for a project. Newly enabled fields appear as grid columns; disabled fields are removed from the grid.
set_project_labels	Replaces all project labels. Existing item references to removed labels are cleaned up by the backend.
set_project_statuses	Replaces all project statuses, including status kinds and check/completion actions.
configure_project_custom_fields	Replaces the ordered custom-field schema and visible-column layout. Existing fields must be archived rather than omitted. Requires LFG Pro for custom-field changes.
configure_project_custom_field_option	Creates or updates one select-field option independently, including its name, color, order, and archive state.

Item tools

Tool	What it does
list_items	Lists items in a project, optionally filtered by search, active/complete status kind, trash state, and limit.
get_item	Gets full item details, including description, resolved status/labels/assignees, comments, and activity.
create_item	Creates a new item in a project.
update_item	Updates an item’s title, short note, or description.
update_item_status	Moves an item to another status by status id.
set_item_custom_field_value	Sets or clears one typed custom-field value without replacing the item’s other custom-field values.
add_item_comment	Adds a comment to an item.

Label tools

Tool	What it does
create_project_label	Creates a project label.
update_project_label	Updates a project label name or color.
delete_project_label	Deletes a project label and lets the backend remove item references.
set_item_labels	Replaces an item’s labels with the supplied label ids.
add_item_label	Adds one project label to an item.
remove_item_label	Removes one project label from an item.

set_project_labels and set_project_statuses are full replacement tools. Include existing ids for labels and statuses that should be kept.

Current limitations

The first hosted MCP release intentionally keeps the surface area small.

Currently, the MCP server does not expose tools to:

• Delete projects or items.
• Empty trash.
• Manage users, billing, or system administration.

If an agent needs one of those actions, it should tell you the action is not available through MCP yet instead of guessing.

Permission model

The MCP server authenticates each request with your Personal Access Token and then calls the LFG List API as you.

That means:

• Project membership controls what the agent can see.
• Normal backend validation still applies.
• Revoking the token immediately removes the agent’s access.