create_or_update_file
Create or update a file in a GitHub repository by specifying owner, repo, path, content, branch, and commit message. Automates file management without direct GitHub access.
Instructions
Create or update a single file in a GitHub repository
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| branch | Yes | Branch to create/update the file in | |
| content | Yes | Content of the file | |
| message | Yes | Commit message | |
| owner | Yes | Repository owner (username or organization) | |
| path | Yes | Path where to create/update the file | |
| repo | Yes | Repository name | |
| sha | No | SHA of the file being replaced (required when updating existing files) |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"branch": {
"description": "Branch to create/update the file in",
"type": "string"
},
"content": {
"description": "Content of the file",
"type": "string"
},
"message": {
"description": "Commit message",
"type": "string"
},
"owner": {
"description": "Repository owner (username or organization)",
"type": "string"
},
"path": {
"description": "Path where to create/update the file",
"type": "string"
},
"repo": {
"description": "Repository name",
"type": "string"
},
"sha": {
"description": "SHA of the file being replaced (required when updating existing files)",
"type": "string"
}
},
"required": [
"owner",
"repo",
"path",
"content",
"message",
"branch"
],
"type": "object"
}
Implementation Reference
- operations/files.ts:109-146 (handler)Core implementation of the create_or_update_file tool: encodes file content, fetches existing SHA if not provided, and performs PUT request to GitHub API to create or update the file.export async function createOrUpdateFile( owner: string, repo: string, path: string, content: string, message: string, branch: string, sha?: string ) { const encodedContent = Buffer.from(content).toString("base64"); let currentSha = sha; if (!currentSha) { try { const existingFile = await getFileContents(owner, repo, path, branch); if (!Array.isArray(existingFile)) { currentSha = existingFile.sha; } } catch (error) { console.error("Note: File does not exist in branch, will create new file"); } } const url = `https://api.github.com/repos/${owner}/${repo}/contents/${path}`; const body = { message, content: encodedContent, branch, ...(currentSha ? { sha: currentSha } : {}), }; const response = await githubRequest(url, { method: "PUT", body, }); return GitHubCreateUpdateFileResponseSchema.parse(response); }
- operations/files.ts:24-32 (schema)Zod schema defining the input parameters for the create_or_update_file tool.export const CreateOrUpdateFileSchema = z.object({ owner: z.string().describe("Repository owner (username or organization)"), repo: z.string().describe("Repository name"), path: z.string().describe("Path where to create/update the file"), content: z.string().describe("Content of the file"), message: z.string().describe("Commit message"), branch: z.string().describe("Branch to create/update the file in"), sha: z.string().optional().describe("SHA of the file being replaced (required when updating existing files)"), });
- index.ts:68-72 (registration)Tool registration in the MCP server's listTools response, specifying name, description, and input schema.{ name: "create_or_update_file", description: "Create or update a single file in a GitHub repository", inputSchema: zodToJsonSchema(files.CreateOrUpdateFileSchema), },
- index.ts:223-237 (handler)MCP server dispatch handler for create_or_update_file: parses arguments using the schema and delegates to the core implementation function.case "create_or_update_file": { const args = files.CreateOrUpdateFileSchema.parse(request.params.arguments); const result = await files.createOrUpdateFile( args.owner, args.repo, args.path, args.content, args.message, args.branch, args.sha ); return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }], }; }