Skip to main content
Smithery for GitHub automatically verifies and deploys your MCP servers directly from your repository. Test every PR with interactive server inspections, get real-time deployment status, and resolve issues faster—all without any manual configuration.

​
Repository Permissions

Smithery requires the following permissions to your connected Github account:
PermissionReadWriteDescription
Contents✓✓Allows us to fetch and write source code in order to generate new pull requests on new branches. We only commit to new branches that we create, so they do not affect your existing branches.
Pull Requests✓✓Enables us to create pull requests for the generated changes and add interactive server inspection links directly within your PR discussions for immediate testing.
Metadata✓✗Allows us to access basic repository information to help provide insights and ensure seamless integration with your GitHub account.
Checks✓✓Enables Smithery to create and view detailed status reports on your server.
Commit Status✓✓Allows us to mark commits with success/failure/pending states that appear in pull requests, showing MCP server deployment status.
Deployments✓✓Provides access to create and manage deployment processes for your MCP servers when code changes.
Issues✓✓Enables Smithery to automatically create issues when problems are detected in your server code or deployment process, helping track and resolve implementation bugs.
Repository Hooks✓✓Allows creation and management of webhooks that notify Smithery when code changes, enabling automated updates to your MCP servers.
These permissions allow Smithery to create a seamless integration with Github, responding automatically to your code changes and keeping your MCP servers up-to-date.

​
Installing the GitHub App

​
Automatic Installation

When you create a new MCP server on Smithery, you’ll be automatically prompted to install the GitHub app for your repositories. This ensures seamless integration from the start.

​
Manual Installation

If you need to install the GitHub app manually or want to grant access to additional repositories, you can do so at any time:
  1. Visit the GitHub App page: https://github.com/apps/smithery-ai
  2. Click “Install” to add the app to your GitHub account or organization
  3. Choose repositories: Select whether to install on:
    • All repositories (current and future)
    • Selected repositories only
  4. Complete installation: Review the permissions and click “Install” to finish

​
Managing Repository Access

After installation, you can modify which repositories Smithery has access to:
  • Go to your GitHub account settings
  • Navigate to Applications → Installed GitHub Apps
  • Find Smithery and click Configure
  • Add or remove repository access as needed
The GitHub app installation is required for Smithery to automatically deploy your MCP servers, create pull request status checks, and provide real-time deployment feedback.
⌘I