fastmcp/docs/python-sdk/fastmcp-cli-install-goose.mdx
Jeremiah Lowin 9b248a15b3
Update repository references for transfer to prefecthq (#3207)
* Update repository references from jlowin/fastmcp to prefecthq/fastmcp

* Retrigger CI after repo transfer

* chore: Update SDK documentation

* Only run deep triage on bug issues for jlowin

---------

Co-authored-by: marvin-context-protocol[bot] <225465937+marvin-context-protocol[bot]@users.noreply.github.com>
2026-02-18 10:33:56 -05:00

67 lines
2 KiB
Text

---
title: goose
sidebarTitle: goose
---
# `fastmcp.cli.install.goose`
Goose integration for FastMCP install using Cyclopts.
## Functions
### `generate_goose_deeplink` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/src/fastmcp/cli/install/goose.py#L29" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
```python
generate_goose_deeplink(name: str, command: str, args: list[str]) -> str
```
Generate a Goose deeplink for installing an MCP extension.
**Args:**
- `name`: Human-readable display name for the extension.
- `command`: The executable command (e.g. "uv").
- `args`: Arguments to the command.
- `description`: Short description shown in Goose.
**Returns:**
- A goose://extension?... deeplink URL.
### `install_goose` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/src/fastmcp/cli/install/goose.py#L86" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
```python
install_goose(file: Path, server_object: str | None, name: str) -> bool
```
Install FastMCP server in Goose via deeplink.
**Args:**
- `file`: Path to the server file.
- `server_object`: Optional server object name (for \:object suffix).
- `name`: Name for the extension in Goose.
- `with_packages`: Optional list of additional packages to install.
- `python_version`: Optional Python version to use.
**Returns:**
- True if installation was successful, False otherwise.
### `goose_command` <sup><a href="https://github.com/PrefectHQ/fastmcp/blob/main/src/fastmcp/cli/install/goose.py#L136" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a></sup>
```python
goose_command(server_spec: str) -> None
```
Install an MCP server in Goose.
Uses uvx to run the server. Environment variables are not included
in the deeplink; use `fastmcp install mcp-json` to generate a full
config for manual installation.
**Args:**
- `server_spec`: Python file to install, optionally with \:object suffix