MiJornada MCP by usefulapi
Read employees, work hours, absences, projects and statements to invoice in MiJornada.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"mijornada": {
"url": "https://mijornada.usefulapi.io/mcp"
}
}
}Remote endpoints
https://mijornada.usefulapi.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (11)
🟢mijornada_get_account
Return the company (name, time zone) and the key this server uses: its scopes and purpose. Use it to test the connection. MiJornada API: GET /me.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢mijornada_list_employees(email, employee_code, worksite_id, status, limit, ...)
List the people in the company, with name, email, employee code, worksite and status. Filter by exact email, employee code, worksite or status. MiJornada API: GET /employees (scope employees:read).
Input Schema
{
"type": "object",
"properties": {
"email": {
"description": "Exact email address.",
"type": "string",
"maxLength": 254,
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"employee_code": {
"description": "The code the company gave the employee.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"worksite_id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Worksite id (the MiJornada id)."
},
"status": {
"description": "ACTIVE or ENDED.",
"type": "string",
"enum": [
"ACTIVE",
"ENDED"
]
},
"limit": {
"description": "Items per page, 1-100 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "The nextCursor of the previous page.",
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢mijornada_get_employee(employee_id)
Return one employee by id. MiJornada API: GET /employees/{id} (scope employees:read).
Input Schema
{
"type": "object",
"properties": {
"employee_id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Employee id (the MiJornada id)."
}
},
"required": [
"employee_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢mijornada_list_worksites
List the company's workplaces (worksites). Use the ids as worksite_id filters. MiJornada API: GET /worksites (scope employees:read).
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢mijornada_list_workdays(from, to, employee_id, include_timeline, limit, ...)
List one row per person and day: worked minutes, breaks, first clock-in, last clock-out, and whether an approved correction applies. These are the figures in force, so use this for payroll. Window: up to 93 days. Pass include_timeline to add each day's movements. MiJornada API: GET /workdays (scope time:read).
Input Schema
{
"type": "object",
"properties": {
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day, in the company time zone."
},
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day, included. At most 93 days after from."
},
"employee_id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Only this employee (the MiJornada id)."
},
"include_timeline": {
"description": "Add the day's clock movements to each row.",
"type": "boolean"
},
"limit": {
"description": "Items per page, 1-100 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "The nextCursor of the previous page.",
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"required": [
"from",
"to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢mijornada_list_time_events(from, to, employee_id, source, limit, ...)
List the raw clock events (in, break, out) in time order. Approved corrections do not change these rows: use mijornada_list_workdays for the figures in force. Window: up to 93 days. MiJornada API: GET /time-events (scope time:read).
Input Schema
{
"type": "object",
"properties": {
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day, in the company time zone."
},
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day, included. At most 93 days after from."
},
"employee_id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Only this employee (the MiJornada id)."
},
"source": {
"description": "Where the clock event was made.",
"type": "string",
"enum": [
"MOBILE",
"KIOSK",
"ADMIN",
"IMPORT",
"SYSTEM"
]
},
"limit": {
"description": "Items per page, 1-100 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "The nextCursor of the previous page.",
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"required": [
"from",
"to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢mijornada_list_absences(from, to, employee_id, status, limit, ...)
List vacations and other absences that overlap the range: type, dates, state and days. Medical leave appears as a plain absence, with no reason or documents. Window: up to a year. MiJornada API: GET /absences (scope absences:read).
Input Schema
{
"type": "object",
"properties": {
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day, in the company time zone."
},
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day, included. At most a year after from."
},
"employee_id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Only this employee (the MiJornada id)."
},
"status": {
"description": "Absence state.",
"type": "string",
"enum": [
"REQUESTED",
"APPROVED",
"REJECTED",
"CANCELLED"
]
},
"limit": {
"description": "Items per page, 1-100 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "The nextCursor of the previous page.",
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"required": [
"from",
"to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢mijornada_list_clients(include_archived, limit, cursor)
List the clients the company works for. Archived clients are left out unless include_archived is true. MiJornada API: GET /clients (scope projects:read).
Input Schema
{
"type": "object",
"properties": {
"include_archived": {
"description": "Include archived clients (default false).",
"type": "boolean"
},
"limit": {
"description": "Items per page, 1-100 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "The nextCursor of the previous page.",
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢mijornada_list_projects(status, client_id, limit, cursor)
List the jobs, sites or assignments the company tracks hours against. Filter by state or client. Rates and money budgets appear only when the key has billing:read. MiJornada API: GET /projects (scope projects:read).
Input Schema
{
"type": "object",
"properties": {
"status": {
"description": "Project state.",
"type": "string",
"enum": [
"ACTIVE",
"DONE",
"ARCHIVED"
]
},
"client_id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Only projects of this client (the MiJornada id)."
},
"limit": {
"description": "Items per page, 1-100 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "The nextCursor of the previous page.",
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢mijornada_list_project_time(from, to, employee_id, project_id, status, ...)
List minutes per person, day, project and activity. A day's lines add up to the minutes worked that day; time on no project has no project_id. Window: up to 93 days. MiJornada API: GET /project-time (scope projects:read).
Input Schema
{
"type": "object",
"properties": {
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day, in the company time zone."
},
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day, included. At most 93 days after from."
},
"employee_id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Only this employee (the MiJornada id)."
},
"project_id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Only this project (the MiJornada id)."
},
"status": {
"description": "Approval state of the hours.",
"type": "string",
"enum": [
"OPEN",
"APPROVED",
"BILLED"
]
},
"limit": {
"description": "Items per page, 1-100 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "The nextCursor of the previous page.",
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"required": [
"from",
"to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢mijornada_list_valuations(from, to, status, limit, cursor)
List issued statements to invoice: approved hours, materials and other lines, priced, with VAT per line. They are not invoices and have no tax validity. Drafts are not listed. Window: up to a year of issue dates. MiJornada API: GET /valuations (scope billing:read).
Input Schema
{
"type": "object",
"properties": {
"from": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First issue date."
},
"to": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last issue date, included. At most a year after from."
},
"status": {
"description": "Statement state.",
"type": "string",
"enum": [
"ISSUED",
"INVOICED",
"VOIDED"
]
},
"limit": {
"description": "Items per page, 1-100 (default 50).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"cursor": {
"description": "The nextCursor of the previous page.",
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"required": [
"from",
"to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence