Skip to content

docs: Add gemini-cli MCP server configuration example#42679

Merged
frenck merged 1 commit into
home-assistant:currentfrom
theundefined:add-gemini-cli-mcp-example
Dec 29, 2025
Merged

docs: Add gemini-cli MCP server configuration example#42679
frenck merged 1 commit into
home-assistant:currentfrom
theundefined:add-gemini-cli-mcp-example

Conversation

@theundefined
Copy link
Copy Markdown
Contributor

Proposed change

Add example of using gemini-cli with home assistant mcp server

Type of change

  • Spelling, grammar or other readability improvements (current branch).
  • Adjusted missing or incorrect information in the current documentation (current branch).
  • Added documentation for a new integration I'm adding to Home Assistant (next branch).
  • Added documentation for a new feature I'm adding to Home Assistant (next branch).
  • Removed stale or deprecated documentation.

Additional information

  • Link to parent pull request in the codebase:
  • Link to parent pull request in the Brands repository:
  • This PR fixes or closes issue: fixes #

Checklist

  • This PR uses the correct branch, based on one of the following:
    • I made a change to the existing documentation and used the current branch.
    • I made a change that is related to an upcoming version of Home Assistant and used the next branch.
  • The documentation follows the Home Assistant documentation standards.

@home-assistant home-assistant Bot added the current This PR goes into the current branch label Dec 21, 2025
@netlify
Copy link
Copy Markdown

netlify Bot commented Dec 21, 2025

Deploy Preview for home-assistant-docs ready!

Name Link
🔨 Latest commit 57c089d
🔍 Latest deploy log https://app.netlify.com/projects/home-assistant-docs/deploys/6948626e374a370008d254cb
😎 Deploy Preview https://deploy-preview-42679--home-assistant-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR adds a configuration example for using the gemini-cli tool with the Home Assistant MCP (Model Context Protocol) Server integration. This provides users with another option for connecting to Home Assistant through an MCP client.

Key changes

  • Adds a new "Example: gemini-cli" section with step-by-step configuration instructions
  • Documents the HTTP-based connection method using headers for authentication with a long-lived access token
  • Follows the existing pattern established by the Claude for Desktop and Cursor examples


### Example: gemini-cli

1. Install `gemini-cli` if you haven't already. You can find installation instructions at [https://geminicli.com/](https://geminicli.com/).
Copy link

Copilot AI Dec 29, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

According to the documentation guidelines, lists should be surrounded by blank lines. There should be a blank line before step 1 to separate it from the preceding paragraph.

Copilot generated this review using guidance from repository custom instructions.
### Example: gemini-cli

1. Install `gemini-cli` if you haven't already. You can find installation instructions at [https://geminicli.com/](https://geminicli.com/).
2. Open the `gemini-cli` configuration file. This is usually located at `~/.gemini/settings.json`. For more details, refer to the [gemini-cli MCP server documentation](https://geminicli.com/docs/tools/mcp-server/).
Copy link

Copilot AI Dec 29, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

File paths should be marked with backticks according to the documentation guidelines. The file path ~/.gemini/settings.json needs backtick formatting.

Copilot generated this review using guidance from repository custom instructions.
Comment thread source/_integrations/mcp_server.markdown
Comment thread source/_integrations/mcp_server.markdown
Comment thread source/_integrations/mcp_server.markdown
Copy link
Copy Markdown
Member

@frenck frenck left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks, @theundefined 👍

../Frenck

                       

Blogging my personal ramblings at frenck.dev

@frenck frenck merged commit 0cbc302 into home-assistant:current Dec 29, 2025
13 checks passed
@github-actions github-actions Bot locked and limited conversation to collaborators Dec 30, 2025
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

current This PR goes into the current branch

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants