ContextQMD
Back to Goose

gotoHuman Extension

documentation/docs/mcp/gotohuman-mcp.md

1.33.15.3 KB
Original Source

import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; import YouTubeShortEmbed from '@site/src/components/YouTubeShortEmbed'; import CLIExtensionInstructions from '@site/src/components/CLIExtensionInstructions'; import GooseDesktopInstaller from '@site/src/components/GooseDesktopInstaller';

<!-- <YouTubeShortEmbed videoUrl="https://www.youtube.com/embed/6aV8pinnUS8" /> -->

This tutorial covers how to add the gotoHuman MCP Server as a goose extension to bring human-in-the-loop approvals into your AI workflows. With gotoHuman, goose can pause and request a review before continuing, perfect for blog drafts, code reviews,compliance checks, etc.

:::tip Quick Install <Tabs groupId="interface"> <TabItem value="ui" label="goose Desktop" default> Launch the installer </TabItem> <TabItem value="cli" label="goose CLI"> Command

sh
 npx -y @gotohuman/mcp-server

Environment Variable

sh
GOTOHUMAN_API_KEY: <YOUR_API_KEY>
</TabItem> </Tabs> :::

Configuration

<Tabs groupId="interface"> <TabItem value="ui" label="goose Desktop" default> <GooseDesktopInstaller extensionId="gotoHuman" extensionName="gotoHuman" description="gotoHuman MCP server for human-in-the-loop approvals" command="npx" args={["-y", "@gotohuman/mcp-server"]} envVars={[ { name: "GOTOHUMAN_API_KEY", label: "gotoHuman API Key" } ]} apiKeyLink="https://app.gotohuman.com/accounts/3kiXJvmf4UDBPKPi9ZNY/api-keys" apiKeyLinkText="GOTOHUMAN_API_KEY" /> </TabItem> <TabItem value="cli" label="goose CLI"> <CLIExtensionInstructions name="gotoHuman MCP" description="gotoHuman MCP server for human-in-the-loop approvals" command="npx -y @gotohuman/mcp-server" timeout={300} envVars={[ { key: "GOTOHUMAN_API_KEY", value: "<YOUR_API_KEY>" } ]} infoNote={ <> Obtain your <a href="https://app.gotohuman.com/accounts/3kiXJvmf4UDBPKPi9ZNY/api-keys" target="_blank" rel="noopener noreferrer">gotoHuman API KEY</a> and paste it in </> } /> </TabItem> </Tabs>

Example Usage

:::tip Before You Start Log in to app.gotohuman.com and go to Review Templates → Create Template.
Follow the steps to create a template and ensure you set a Webhook Endpoint (you can use webhook.site for testing).
:::

In this example, goose sends a LinkedIn post draft to gotoHuman for approval using the n8n news to post template that was created.

<Tabs groupId="interface"> <TabItem value="ui" label="goose Desktop" default> 1. Open a new session in goose Desktop </TabItem> <TabItem value="cli" label="goose CLI">
  1. Open a terminal and start a new goose session:
sh
goose session
</TabItem> </Tabs>

goose Prompt

Send this blog draft about goose to gotoHuman for review using my `n8n news to post` form. 

Include today’s date as the timestamp, these links: 
[goose Docs: https://goose-docs.ai/, gotoHuman: https://gotohuman.com/], 
summarize it as ‘Introducing goose’s integration with gotoHuman for human approvals,’ 
and here’s the draft:

goose is an open-source AI agent that runs locally on your machine, right in your terminal or IDE. 
It connects to MCP servers like gotoHuman to extend its abilities. While goose can automate tasks, 
sometimes you need a human in the loop. With gotoHuman MCP, you can add approval steps into any workflow;
from reviewing a LinkedIn post draft to signing off on a code change. 
Once approved, goose can continue where it left off. 
This makes agent workflows safer, more collaborative, and better suited for real-world teams.

goose Output

:::note Desktop

─── list-forms ──────────────────────────

Now let me search for some specific setup and usage information:

─── Get-Form-Schema

Let me search for more technical details and examples:

─── Request-human-review-with-form ────────────

Perfect! I've successfully sent your goose blog draft to gotoHuman for review using your "n8n news to post" form. Here's what was submitted: Review Request Details

Submitted Content

  • Timestamp: 2025-09-23
  • Summary: Introducing goose's integration with gotoHuman for human approvals
  • Links:
    • goose Docs
    • gotoHuman
  • Draft: Your complete blog post about goose's integration with gotoHuman

The review request has been created and is now ready for human approval. You can access it through the review link provided above. Once the review is completed, you'll be able to proceed with publishing or making any requested changes to the blog post. :::

Review in gotoHuman

Now if you open the Review Link from goose’s output, you’ll see the request waiting in your gotoHuman dashboard: