Skip to main content

Grove MCP tools reference

Every tool Grove's MCP server offers to AI assistants, what it does, and which ones ask before they change anything.

Written by Jack Meyers

Grove has an MCP server. MCP (Model Context Protocol) is a standard way to connect an AI assistant to another app. Any assistant that supports custom MCP connectors can use Grove's tools. To connect one, see Use Grove from your own AI assistant.

Connection details

  • Address: https://grovehq.app/api/mcp

  • Sign-in: OAuth. The first time your assistant uses Grove, you sign in and approve access.

  • Workspace: the tools work in the workspace you signed in to.

  • Access: the tools act as you. Your assistant can see and change only what you can in Grove.

  • Time limit: each call can run for up to 85 seconds. A write that timed out may still have landed. Read it back before you try again.

If your sign-in expires, your assistant asks you to sign in again.

Find and read

Tool

What it does

list_initiatives

Finds initiatives by name or slug, newest first.

list_projects

Finds projects by name, description, or ID, across the workspace or in one initiative.

get_initiative

Reads an initiative's details, and lists its documents.

get_project

Reads a project's details.

read_document

Reads one document of a project or initiative in full, or a Scratchpad file.

get_document_standard

Reads the writing standard for a project's summary or Requirements.

These tools change nothing.

Write and organize

Tool

What it does

Asks you first?

write_project_document

Replaces a project's summary, its outcomes list, or its Requirements. Creates or changes a Scratchpad document or visual.

It reads the document and its standard first.

create_initiative

Creates an initiative.

Yes. Your assistant drafts the name and description with you.

edit_initiative

Changes an initiative's details, such as its name, lead, dates, priority, and status.

Yes. It shows each value before and after.

create_project

Creates a project in an initiative.

Yes.

edit_project

Changes a project's details: name, description, status, lead, members, dates, and priority.

Yes. It shows each value before and after.

move_project

Moves a project to another initiative.

Yes. It names the project, where it is, and where it will go.

Threads

Tool

What it does

Asks you first?

list_threads

Lists a project's or initiative's threads.

No. It changes nothing.

get_thread

Reads one thread, with every post.

No. It changes nothing.

raise_thread

Raises a thread on a project, initiative, document, or passage. Nobody is notified.

Use it for points that need a person's decision.

reply_to_thread

Replies in a thread. A reply reopens a settled thread.

Posts can't be edited or deleted.

settle_thread

Closes a thread.

Only once the product lead has decided.

Archive

Tool

What it does

Asks you first?

archive_initiatives

Archives initiatives, and every project in them.

Yes, by name and slug.

archive_projects

Archives projects.

Yes, by ID and name.

You can't undo archiving in Grove.

How the "asks you first" rules work

Each tool's description tells your assistant when to stop and get your OK. Most assistants also show you each tool call before it runs. Read what the assistant plans to change before you approve it.

Related articles

Did this answer your question?