Provides authenticated access to a specific private GitHub repository for file content retrieval, code search, issue search, and detailed commit history with file diffs.
Log in to Your GitHub Account
Create a New Personal Access Token
- Click the “Generate new token” button.
- Give your token a name/description (e.g., “Obsidian GitHub MCP”).
- Select the appropriate expiration (recommended: set an expiration date for better security).
Select Token Scopes
- For private repositories, check the box for
repo
.
- For public repositories, check the box for
public_repo
.
- If you are connecting to organization repositories, check
read:org
.
Generate and Copy the Token
- Click “Generate token” to create it.
- Copy the token immediately—the full token is displayed only once and cannot be retrieved again.
Gather Other Repository Details
- Note your GitHub username or organization name for
GITHUB_OWNER
.
- Note the repository name that contains your Obsidian vault for
GITHUB_REPO
.
Fill Values in the FastMCP Connection Interface
- In the FastMCP connection window, click the "Install Now" button for this connection.
- Enter the following values:
GITHUB_TOKEN
: The personal access token you generated.
GITHUB_OWNER
: Your GitHub username or organization name.
GITHUB_REPO
: The name of the repository containing your Obsidian vault.
Save and Confirm
- Save your settings and confirm that the connection is successful.
The required environment variables are:
GITHUB_TOKEN
GITHUB_OWNER
GITHUB_REPO