MCP ERPNext

Login to ERPNext with username/password and optional TOTP. Call this first before other operations.

Get the employee record linked to the currently logged in user

List all available activity types for timesheets

List all projects

List tasks for a specific project

Create a new timesheet with time logs.

Create a timesheet for today with a single entry

List timesheets with optional filters

Get details of a specific timesheet

Get all draft timesheets for current employee

Add time log to existing draft timesheet

Submit a draft timesheet

Cancel a submitted timesheet

Create weekly timesheet: 7h Billable + 2h Non-Billable per day, Mon-Fri

Create timesheet with custom entries

Update a specific time log in a draft timesheet. Use this to edit hours, times, project, activity type, or description of an existing time entry.

Remove a specific time log from a draft timesheet. Cannot remove the last time log.

Update the note on a draft timesheet

Delete a draft timesheet. Only works on timesheets that have not been submitted.

List all available leave types

Get leave balance for employee

List leave applications with filters

Get details of a specific leave application

Get pending leave applications for current employee

Get approved leave applications for current employee

Apply for leave (single or multiple days)

Submit leave application for approval

Cancel a leave application

Create a software release document in ERPNext from GitLab merge request URL(s). When template_release_url is provided, auto-fills Product, Customer, and Reviewer from that release. Also auto-fetches: Redmine IDs from MR description (#123456), patch/test report URLs from MR notes, and Redmine ticket …

Preview what a software release will look like BEFORE creating it. Shows all auto-detected fields, their sources, and any missing required fields. Use this to review the release details before calling erpnext_create_software_release.

List available products (Brands) for software release selection

List available customers for software release selection

Get details from a GitLab merge request URL including auto-detected customer, version, Redmine IDs from description, and auto-fetched patch/test report URLs from MR notes

Get Redmine issue details (title/subject) from issue ID or URL. Requires REDMINE_API_KEY to be configured.

Get FULL Redmine issue details from an ID or URL: description, status, priority, assignee, done ratio, comments/journal notes, attachments, sub-tasks (children) and relations. Use this (not erpnext_get_redmine_issue) when you need the actual issue content, reported bugs, or discussion. Requires REDM…

Update a Redmine issue: add a comment/note and/or change fields (status, assignee, priority, done ratio, subject, description, dates). Provide either status_id or status_name (name is resolved automatically). Requires REDMINE_API_KEY with write permission on the project.

Create a NEW Redmine issue in a project. Use this to open a fresh ticket (e.g. a Clarification/tracking ticket) — distinct from erpnext_update_redmine_issue, which only edits an existing issue. Some projects require assignee (yourself), due date and certain custom fields (e.g. Complexity); pass assi…

Get details of an existing software release (can be used as template reference)

List recent software releases with optional filters

Download a file attachment from a Redmine issue to local disk (e.g. an issue's SQL script, spreadsheet, or document). Accepts the attachment id or a Redmine attachment download URL. Returns the saved file path, metadata, and — for text-like files — a content preview. Requires REDMINE_API_KEY.

List merge requests from a GitLab project with filters (state, author, date range). Returns a list of MRs that can be selected for task creation analysis.

Analyze one or multiple GitLab merge requests and generate intelligent task breakdown. Extracts commits, groups them by type (features/fixes/refactors), and identifies Redmine issues from MR descriptions. Returns suggested tasks for user review before creation.

Create tasks in ERPNext from previously analyzed merge request data. Tasks are created with "Completed" status and automatically assigned to the current employee.

Get Developer Tasks assigned to a developer (defaults to the logged-in user) with optional filters by date range, status, product, or subject search. Returns the tasks plus a breakdown of task counts per client/project (SBI, ICICI, TCIL/Mudra 2, etc.). Useful for building a delivery footprint or act…

Validate a Taiga User Story by its URL and return its id, title and project. Use this before creating tasks to confirm the user story exists and to obtain the user_story_id.

Create a new User Story in a Taiga project. Returns the created user story id, ref and URL. Use the returned user_story_id with erpnext_create_taiga_tasks to add tasks under it.

Create one or more tasks in Taiga under a given User Story. Resolves assignees from project members and sets custom attributes (complexity, task_type) when those attributes exist on the project. Returns created task refs/ids and any failures.

Export tasks to ERPNext as "Developer Task" documents. Resolves the developer (employee code) from a name when not provided, maps the Taiga task_type to an ERP category, and normalizes complexity. Returns created ids, in-batch skips, and failures.

Get Taiga tasks assigned to a user (defaults to the authenticated user), with each task's description and attachment metadata. Optionally filter by project (slug or name) and status; by default only OPEN tasks are returned. Use this to read a task's description and see its attachments (download them…

Get ALL tasks under a Taiga user story (any assignee) with their FULL descriptions, plus the merge-commit SHAs and Redmine issue ids referenced in each description. Use this — not erpnext_get_taiga_tasks — when working from a user story URL/ref, e.g. to collect the 'Ready for test' points of a sprin…

Update a Taiga task's status and/or description. Identify the task by numeric task_id, or by ref + project (slug or name). Status names are resolved to the project's status ids automatically.

Download a Taiga task attachment to local disk. Provide the attachment url (from erpnext_get_taiga_tasks) or a numeric attachment_id. Returns the saved file path and — for text-like files — a content preview.