Freshdesk

Freshdesk MCP Server for Cloudflare Workers

Available Tools

97 tools available in the Freshdesk MCP server. Each tool can be called by AI assistants to perform specific actions.

freshdesk_get_forum

Get a single forum by ID.

Args:

id: The forum ID (required)
format: Response format (json, markdown)

Returns: Forum details.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Forum ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshdesk_list_canned_responses

List all canned responses in a folder.

Args:

folder_id: Folder ID (required)
format: Response format (json, markdown)

Returns: List of canned responses in the folder.

{
  "type": "object",
  "required": [
    "folder_id"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "folder_id": {
      "type": "integer",
      "description": "Folder ID"
    }
  }
}

freshdesk_get_canned_response_folder

Get a single canned response folder by ID.

Args:

id: The folder ID (required)
format: Response format (json, markdown)

Returns: Folder details.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Folder ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshdesk_create_canned_response_folder

Create a new canned response folder.

Args:

name: Folder name (required)

Returns: The created folder.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Folder name"
    }
  }
}

freshdesk_delete_canned_response_folder

Delete a canned response folder.

Args:

id: Folder ID (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Folder ID"
    }
  }
}

freshdesk_delete_solution_article

Delete a solution article.

Args:

id: Article ID (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Article ID"
    }
  }
}

freshdesk_list_agents

List agents from Freshdesk with pagination and filtering.

Args:

page: Page number (default: 1)
per_page: Agents per page (1-100, default: 30)
email: Filter by email
state: Filter by state (fulltime, occasional)
format: Response format (json, markdown)

Returns: List of agents with their details.

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "email": {
      "type": "string",
      "description": "Filter by email"
    },
    "state": {
      "enum": [
        "fulltime",
        "occasional"
      ],
      "type": "string",
      "description": "Filter by state"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "per_page": {
      "type": "integer",
      "default": 30,
      "maximum": 100,
      "minimum": 1,
      "description": "Agents per page"
    }
  }
}

freshdesk_get_agent

Get a single agent by ID.

Args:

id: The agent ID (required)
format: Response format (json, markdown)

Returns: Complete agent details.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Agent ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshdesk_get_current_agent

Get the currently authenticated agent.

Args:

format: Response format (json, markdown)

Returns: Details of the authenticated agent.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshdesk_update_agent

Update an existing agent.

Args:

id: Agent ID (required)
occasional: Is occasional agent
signature: Email signature
ticket_scope: Ticket visibility scope
group_ids: Group IDs the agent belongs to
role_ids: Role IDs for the agent
skill_ids: Skill IDs for the agent

Returns: The updated agent.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Agent ID"
    },
    "role_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "group_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "signature": {
      "type": "string"
    },
    "skill_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "occasional": {
      "type": "boolean"
    },
    "ticket_scope": {
      "type": "integer"
    }
  }
}

freshdesk_delete_agent

Delete an agent.

Args:

id: Agent ID (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Agent ID"
    }
  }
}

freshdesk_list_groups

List agent groups from Freshdesk with pagination.

Args:

page: Page number (default: 1)
per_page: Groups per page (1-100, default: 30)
format: Response format (json, markdown)

Returns: List of groups with their details.

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "per_page": {
      "type": "integer",
      "default": 30,
      "maximum": 100,
      "minimum": 1,
      "description": "Groups per page"
    }
  }
}

freshdesk_get_group

Get a single group by ID.

Args:

id: The group ID (required)
format: Response format (json, markdown)

Returns: Complete group details including agent IDs.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Group ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshdesk_create_group

Create a new agent group.

Args:

name: Group name (required)
description: Group description
business_hour_id: Business hour ID to apply
escalate_to: Group ID to escalate to
unassigned_for: Time string for unassigned escalation
agent_ids: Array of agent IDs to add
auto_ticket_assign: Enable auto ticket assignment

Returns: The created group.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Group name"
    },
    "agent_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "description": {
      "type": "string"
    },
    "escalate_to": {
      "type": "integer"
    },
    "unassigned_for": {
      "type": "string"
    },
    "business_hour_id": {
      "type": "integer"
    },
    "auto_ticket_assign": {
      "type": "boolean"
    }
  }
}

freshdesk_update_group

Update an existing group.

Args:

id: Group ID (required)
name: New name
description: New description
business_hour_id: New business hour ID
escalate_to: New escalation group ID
agent_ids: New agent IDs array
auto_ticket_assign: Enable/disable auto assignment

Returns: The updated group.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Group ID"
    },
    "name": {
      "type": "string"
    },
    "agent_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "description": {
      "type": "string"
    },
    "escalate_to": {
      "type": "integer"
    },
    "business_hour_id": {
      "type": "integer"
    },
    "auto_ticket_assign": {
      "type": "boolean"
    }
  }
}

freshdesk_delete_group

Delete a group.

Args:

id: Group ID (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Group ID"
    }
  }
}

freshdesk_list_roles

List all roles from Freshdesk.

Args:

format: Response format (json, markdown)

Returns: List of roles.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

freshdesk_get_role

Get a single role by ID.

Args:

id: The role ID (required)
format: Response format (json, markdown)

Returns: Role details.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Role ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshdesk_list_canned_response_folders

List all canned response folders.

Args:

format: Response format (json, markdown)

Returns: List of canned response folders.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

freshdesk_update_canned_response_folder

Update a canned response folder.

Args:

id: Folder ID (required)
name: New name (required)

Returns: The updated folder.

{
  "type": "object",
  "required": [
    "id",
    "name"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Folder ID"
    },
    "name": {
      "type": "string",
      "description": "New folder name"
    }
  }
}

freshdesk_get_canned_response

Get a single canned response by ID.

Args:

id: The canned response ID (required)
format: Response format (json, markdown)

Returns: Canned response details including content.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Canned response ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshdesk_create_canned_response

Create a new canned response in a folder.

Args:

folder_id: Folder ID (required)
title: Response title (required)
content: Response content (required)
content_html: HTML content (optional)

Returns: The created canned response.

{
  "type": "object",
  "required": [
    "folder_id",
    "title",
    "content"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "Response title"
    },
    "content": {
      "type": "string",
      "description": "Response content"
    },
    "folder_id": {
      "type": "integer",
      "description": "Folder ID"
    },
    "content_html": {
      "type": "string",
      "description": "HTML content"
    }
  }
}

freshdesk_update_canned_response

Update an existing canned response.

Args:

id: Canned response ID (required)
title: New title
content: New content
content_html: New HTML content

Returns: The updated canned response.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Canned response ID"
    },
    "title": {
      "type": "string"
    },
    "content": {
      "type": "string"
    },
    "content_html": {
      "type": "string"
    }
  }
}

freshdesk_delete_canned_response

Delete a canned response.

Args:

id: Canned response ID (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Canned response ID"
    }
  }
}

freshdesk_list_companies

List companies from Freshdesk with pagination.

Args:

page: Page number for pagination (default: 1)
per_page: Number of companies per page (1-100, default: 30)
format: Response format (json, markdown)

Returns: List of companies with their details.

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "per_page": {
      "type": "integer",
      "default": 30,
      "maximum": 100,
      "minimum": 1,
      "description": "Companies per page"
    }
  }
}

freshdesk_get_company

Get a single company by ID.

Args:

id: The company ID (required)
format: Response format (json, markdown)

Returns: Complete company details.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Company ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshdesk_create_company

Create a new company.

Args:

name: Company name (required)
domains: Array of company domains
description: Description
note: Note
health_score: Health score
account_tier: Account tier
renewal_date: Renewal date
industry: Industry

Returns: The created company.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Company name"
    },
    "note": {
      "type": "string"
    },
    "domains": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Company domains"
    },
    "industry": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "account_tier": {
      "type": "string"
    },
    "health_score": {
      "type": "string"
    },
    "renewal_date": {
      "type": "string"
    }
  }
}

freshdesk_update_company

Update an existing company.

Args:

id: Company ID (required)
name: New name
domains: New domains array
description: New description
note: New note
health_score: New health score
account_tier: New account tier
renewal_date: New renewal date
industry: New industry

Returns: The updated company.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Company ID"
    },
    "name": {
      "type": "string"
    },
    "note": {
      "type": "string"
    },
    "domains": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "industry": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "account_tier": {
      "type": "string"
    },
    "health_score": {
      "type": "string"
    },
    "renewal_date": {
      "type": "string"
    }
  }
}

freshdesk_delete_company

Delete a company.

Args:

id: Company ID (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Company ID"
    }
  }
}

freshdesk_search_companies

Search for companies using Freshdesk's search query syntax.

Args:

query: Search query (e.g., "name:'Acme'", "domain:'acme.com'")
page: Page number (1-10)
format: Response format (json, markdown)

Returns: Matching companies and total count.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "maximum": 10,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshdesk_get_forum_category

Get a single forum category by ID.

Args:

id: The category ID (required)
format: Response format (json, markdown)

Returns: Category details.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Category ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshdesk_list_forums

List all forums in a category.

Args:

category_id: Category ID (required)
format: Response format (json, markdown)

Returns: List of forums in the category.

{
  "type": "object",
  "required": [
    "category_id"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "category_id": {
      "type": "integer",
      "description": "Category ID"
    }
  }
}

freshdesk_list_contacts

List contacts from Freshdesk with pagination and filtering.

Args:

page: Page number for pagination (default: 1)
per_page: Number of contacts per page (1-100, default: 30)
email: Filter by email address
phone: Filter by phone number
mobile: Filter by mobile number
company_id: Filter by company ID
state: Filter by state (verified, unverified, blocked, deleted)
updated_since: Return contacts updated after this date (ISO 8601)
format: Response format (json, markdown)

Returns: List of contacts with their details.

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "email": {
      "type": "string",
      "description": "Filter by email"
    },
    "phone": {
      "type": "string",
      "description": "Filter by phone"
    },
    "state": {
      "enum": [
        "verified",
        "unverified",
        "blocked",
        "deleted"
      ],
      "type": "string",
      "description": "Filter by state"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "mobile": {
      "type": "string",
      "description": "Filter by mobile"
    },
    "per_page": {
      "type": "integer",
      "default": 30,
      "maximum": 100,
      "minimum": 1,
      "description": "Contacts per page"
    },
    "company_id": {
      "type": "integer",
      "description": "Filter by company ID"
    },
    "updated_since": {
      "type": "string",
      "description": "Return contacts updated after this ISO 8601 date"
    }
  }
}

freshdesk_get_contact

Get a single contact by ID.

Args:

id: The contact ID (required)
format: Response format (json, markdown)

Returns: Complete contact details.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Contact ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshdesk_list_products

List all products from Freshdesk.

Args:

format: Response format (json, markdown)

Returns: List of products.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

freshdesk_create_contact

Create a new contact.

Args:

name: Contact name (required)
email: Email address
phone: Phone number
mobile: Mobile number
twitter_id: Twitter handle
unique_external_id: External ID
company_id: Associated company ID
view_all_tickets: Can view all company tickets
address: Address
description: Description
job_title: Job title
language: Language
time_zone: Time zone
tags: Array of tags

Returns: The created contact.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Contact name"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "email": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "mobile": {
      "type": "string"
    },
    "address": {
      "type": "string"
    },
    "language": {
      "type": "string"
    },
    "job_title": {
      "type": "string"
    },
    "time_zone": {
      "type": "string"
    },
    "company_id": {
      "type": "integer"
    },
    "twitter_id": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "view_all_tickets": {
      "type": "boolean"
    },
    "unique_external_id": {
      "type": "string"
    }
  }
}

freshdesk_update_contact

Update an existing contact.

Args:

id: Contact ID (required)
name: New name
email: New email
phone: New phone
mobile: New mobile
company_id: New company ID
address: New address
description: New description
job_title: New job title
tags: New tags array

Returns: The updated contact.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Contact ID"
    },
    "name": {
      "type": "string"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "email": {
      "type": "string"
    },
    "phone": {
      "type": "string"
    },
    "mobile": {
      "type": "string"
    },
    "address": {
      "type": "string"
    },
    "job_title": {
      "type": "string"
    },
    "company_id": {
      "type": "integer"
    },
    "description": {
      "type": "string"
    }
  }
}

freshdesk_delete_contact

Soft delete a contact (can be restored).

Args:

id: Contact ID (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Contact ID"
    }
  }
}

freshdesk_restore_contact

Restore a soft-deleted contact.

Args:

id: Contact ID (required)

Returns: Confirmation of restoration.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Contact ID"
    }
  }
}

freshdesk_hard_delete_contact

Permanently delete a contact (cannot be undone).

Args:

id: Contact ID (required)

Returns: Confirmation of permanent deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Contact ID"
    }
  }
}

freshdesk_search_contacts

Search for contacts using Freshdesk's search query syntax.

Args:

query: Search query (e.g., "email:'john@example.com'", "company_id:123")
page: Page number (1-10)
format: Response format (json, markdown)

Returns: Matching contacts and total count.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "maximum": 10,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshdesk_merge_contacts

Merge multiple contacts into one primary contact.

Args:

primary_id: ID of the primary contact to keep (required)
secondary_ids: Array of contact IDs to merge into primary (required)

Returns: Confirmation of merge.

{
  "type": "object",
  "required": [
    "primary_id",
    "secondary_ids"
  ],
  "properties": {
    "primary_id": {
      "type": "integer",
      "description": "Primary contact ID"
    },
    "secondary_ids": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Secondary contact IDs to merge"
    }
  }
}

freshdesk_make_agent

Convert a contact into an agent.

Args:

id: Contact ID (required)

Returns: The newly created agent.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Contact ID"
    }
  }
}

freshdesk_list_forum_categories

List all forum categories.

Args:

format: Response format (json, markdown)

Returns: List of forum categories.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

freshdesk_list_topics

List all topics in a forum.

Args:

forum_id: Forum ID (required)
page: Page number
per_page: Topics per page
format: Response format (json, markdown)

Returns: List of topics in the forum.

{
  "type": "object",
  "required": [
    "forum_id"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "forum_id": {
      "type": "integer",
      "description": "Forum ID"
    },
    "per_page": {
      "type": "integer",
      "default": 30,
      "maximum": 100,
      "minimum": 1
    }
  }
}

freshdesk_get_topic

Get a single topic by ID.

Args:

id: The topic ID (required)
format: Response format (json, markdown)

Returns: Topic details.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Topic ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshdesk_list_topic_comments

List all comments on a topic.

Args:

topic_id: Topic ID (required)
page: Page number
per_page: Comments per page
format: Response format (json, markdown)

Returns: List of comments on the topic.

{
  "type": "object",
  "required": [
    "topic_id"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "per_page": {
      "type": "integer",
      "default": 30,
      "maximum": 100,
      "minimum": 1
    },
    "topic_id": {
      "type": "integer",
      "description": "Topic ID"
    }
  }
}

freshdesk_get_product

Get a single product by ID.

Args:

id: The product ID (required)
format: Response format (json, markdown)

Returns: Product details.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Product ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshdesk_create_product

Create a new product.

Args:

name: Product name (required)
description: Product description
primary_email: Primary support email

Returns: The created product.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Product name"
    },
    "description": {
      "type": "string"
    },
    "primary_email": {
      "type": "string"
    }
  }
}

freshdesk_update_product

Update an existing product.

Args:

id: Product ID (required)
name: New name
description: New description
primary_email: New primary email

Returns: The updated product.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Product ID"
    },
    "name": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "primary_email": {
      "type": "string"
    }
  }
}

freshdesk_delete_product

Delete a product.

Args:

id: Product ID (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Product ID"
    }
  }
}

freshdesk_list_business_hours

List all business hours configurations.

Args:

format: Response format (json, markdown)

Returns: List of business hours.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

freshdesk_get_business_hour

Get a single business hour configuration by ID.

Args:

id: The business hour ID (required)
format: Response format (json, markdown)

Returns: Business hour details including schedule.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Business hour ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshdesk_list_sla_policies

List all SLA policies.

Args:

format: Response format (json, markdown)

Returns: List of SLA policies.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

freshdesk_get_sla_policy

Get a single SLA policy by ID.

Args:

id: The SLA policy ID (required)
format: Response format (json, markdown)

Returns: SLA policy details including targets and escalation rules.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "SLA policy ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshdesk_list_email_configs

List all email configurations.

Args:

format: Response format (json, markdown)

Returns: List of email configurations.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

freshdesk_get_email_config

Get a single email configuration by ID.

Args:

id: The email config ID (required)
format: Response format (json, markdown)

Returns: Email configuration details.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Email config ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshdesk_list_ticket_fields

List all ticket fields (including custom fields).

Args:

format: Response format (json, markdown)

Returns: List of ticket fields with their properties.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

freshdesk_get_ticket_field

Get a single ticket field by ID.

Args:

id: The ticket field ID (required)
format: Response format (json, markdown)

Returns: Ticket field details including choices if applicable.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Ticket field ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshdesk_list_solution_categories

List all solution (knowledge base) categories.

Args:

format: Response format (json, markdown)

Returns: List of solution categories.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

freshdesk_get_solution_category

Get a single solution category by ID.

Args:

id: The category ID (required)
format: Response format (json, markdown)

Returns: Category details.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Category ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshdesk_create_solution_category

Create a new solution category.

Args:

name: Category name (required)
description: Category description
visible_in_portals: Array of portal IDs

Returns: The created category.

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Category name"
    },
    "description": {
      "type": "string"
    },
    "visible_in_portals": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  }
}

freshdesk_update_solution_category

Update an existing solution category.

Args:

id: Category ID (required)
name: New name
description: New description

Returns: The updated category.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Category ID"
    },
    "name": {
      "type": "string"
    },
    "description": {
      "type": "string"
    }
  }
}

freshdesk_delete_solution_category

Delete a solution category.

Args:

id: Category ID (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Category ID"
    }
  }
}

freshdesk_list_solution_folders

List all folders in a solution category.

Args:

category_id: Category ID (required)
format: Response format (json, markdown)

Returns: List of folders in the category.

{
  "type": "object",
  "required": [
    "category_id"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "category_id": {
      "type": "integer",
      "description": "Category ID"
    }
  }
}

freshdesk_get_solution_folder

Get a single solution folder by ID.

Args:

id: The folder ID (required)
format: Response format (json, markdown)

Returns: Folder details.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Folder ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshdesk_create_solution_folder

Create a new solution folder in a category.

Args:

category_id: Category ID (required)
name: Folder name (required)
description: Folder description
visibility: Visibility level (1=All users, 2=Logged in users, 3=Agents only)

Returns: The created folder.

{
  "type": "object",
  "required": [
    "category_id",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Folder name"
    },
    "visibility": {
      "type": "integer",
      "maximum": 3,
      "minimum": 1,
      "description": "1=All, 2=Logged in, 3=Agents"
    },
    "category_id": {
      "type": "integer",
      "description": "Category ID"
    },
    "description": {
      "type": "string"
    }
  }
}

freshdesk_update_solution_folder

Update an existing solution folder.

Args:

id: Folder ID (required)
name: New name
description: New description
visibility: New visibility level

Returns: The updated folder.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Folder ID"
    },
    "name": {
      "type": "string"
    },
    "visibility": {
      "type": "integer",
      "maximum": 3,
      "minimum": 1
    },
    "description": {
      "type": "string"
    }
  }
}

freshdesk_delete_solution_folder

Delete a solution folder.

Args:

id: Folder ID (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Folder ID"
    }
  }
}

freshdesk_list_solution_articles

List all articles in a solution folder.

Args:

folder_id: Folder ID (required)
format: Response format (json, markdown)

Returns: List of articles in the folder.

{
  "type": "object",
  "required": [
    "folder_id"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "folder_id": {
      "type": "integer",
      "description": "Folder ID"
    }
  }
}

freshdesk_get_solution_article

Get a single solution article by ID.

Args:

id: The article ID (required)
format: Response format (json, markdown)

Returns: Article details including content.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Article ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshdesk_create_solution_article

Create a new solution article in a folder.

Args:

folder_id: Folder ID (required)
title: Article title (required)
description: Article content in HTML (required)
status: Article status (1=Draft, 2=Published)
tags: Array of tags

Returns: The created article.

{
  "type": "object",
  "required": [
    "folder_id",
    "title",
    "description"
  ],
  "properties": {
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "title": {
      "type": "string",
      "description": "Article title"
    },
    "status": {
      "type": "integer",
      "maximum": 2,
      "minimum": 1,
      "description": "1=Draft, 2=Published"
    },
    "folder_id": {
      "type": "integer",
      "description": "Folder ID"
    },
    "description": {
      "type": "string",
      "description": "Article content (HTML)"
    }
  }
}

freshdesk_update_solution_article

Update an existing solution article.

Args:

id: Article ID (required)
title: New title
description: New content (HTML)
status: New status (1=Draft, 2=Published)
tags: New tags array

Returns: The updated article.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Article ID"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "title": {
      "type": "string"
    },
    "status": {
      "type": "integer",
      "maximum": 2,
      "minimum": 1
    },
    "description": {
      "type": "string"
    }
  }
}

freshdesk_search_solutions

Search for solution articles by keyword.

Args:

term: Search term (required)
format: Response format (json, markdown)

Returns: Matching articles.

{
  "type": "object",
  "required": [
    "term"
  ],
  "properties": {
    "term": {
      "type": "string",
      "description": "Search term"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

freshdesk_list_surveys

List all surveys.

Args:

format: Response format (json, markdown)

Returns: List of surveys.

{
  "type": "object",
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    }
  }
}

freshdesk_get_survey

Get a single survey by ID.

Args:

id: The survey ID (required)
format: Response format (json, markdown)

Returns: Survey details.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Survey ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshdesk_list_satisfaction_ratings

List satisfaction ratings with pagination and filtering.

Args:

page: Page number (default: 1)
per_page: Ratings per page (1-100, default: 30)
created_since: Filter ratings created after this date (ISO 8601)
format: Response format (json, markdown)

Returns: List of satisfaction ratings.

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "per_page": {
      "type": "integer",
      "default": 30,
      "maximum": 100,
      "minimum": 1,
      "description": "Ratings per page"
    },
    "created_since": {
      "type": "string",
      "description": "Filter after this date"
    }
  }
}

freshdesk_get_ticket_satisfaction_ratings

Get satisfaction ratings for a specific ticket.

Args:

ticket_id: Ticket ID (required)
format: Response format (json, markdown)

Returns: Satisfaction ratings for the ticket.

{
  "type": "object",
  "required": [
    "ticket_id"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "ticket_id": {
      "type": "integer",
      "description": "Ticket ID"
    }
  }
}

freshdesk_list_conversations

List all conversations (notes and replies) on a ticket.

Args:

ticket_id: Ticket ID (required)
page: Page number
per_page: Items per page
format: Response format

Returns: List of conversations on the ticket.

{
  "type": "object",
  "required": [
    "ticket_id"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "per_page": {
      "type": "integer",
      "default": 30,
      "maximum": 100,
      "minimum": 1
    },
    "ticket_id": {
      "type": "integer",
      "description": "Ticket ID"
    }
  }
}

freshdesk_update_conversation

Update a conversation (note or reply).

Args:

id: Conversation ID (required)
body: New body content (HTML)

Returns: The updated conversation.

{
  "type": "object",
  "required": [
    "id",
    "body"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Conversation ID"
    },
    "body": {
      "type": "string",
      "description": "New body (HTML)"
    }
  }
}

freshdesk_list_tickets

List support tickets from Freshdesk with pagination and filtering.

Args:

page: Page number for pagination (default: 1)
per_page: Number of tickets per page (1-100, default: 30)
filter: Predefined filter (new_and_my_open, watching, spam, deleted)
order_by: Field to order by (created_at, due_by, updated_at, status)
order_type: Sort direction (asc, desc)
updated_since: Return tickets updated after this date (ISO 8601)
format: Response format (json, markdown)

Returns: List of tickets with id, subject, status, priority, and timestamps.

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "filter": {
      "enum": [
        "new_and_my_open",
        "watching",
        "spam",
        "deleted"
      ],
      "type": "string",
      "description": "Predefined filter"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "order_by": {
      "enum": [
        "created_at",
        "due_by",
        "updated_at",
        "status"
      ],
      "type": "string",
      "description": "Field to order by"
    },
    "per_page": {
      "type": "integer",
      "default": 30,
      "maximum": 100,
      "minimum": 1,
      "description": "Tickets per page"
    },
    "order_type": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "description": "Sort direction"
    },
    "updated_since": {
      "type": "string",
      "description": "Return tickets updated after this ISO 8601 date"
    }
  }
}

freshdesk_get_ticket

Get a single ticket by ID with full details.

Args:

id: The ticket ID (required)
include: Comma-separated list of related objects to include (conversations, requester, company, stats)
format: Response format (json, markdown)

Returns: Complete ticket details including subject, description, status, priority, tags, and custom fields.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Ticket ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    },
    "include": {
      "type": "string",
      "description": "Comma-separated: conversations,requester,company,stats"
    }
  }
}

freshdesk_get_time_entry

Get a single time entry by ID.

Args:

id: The time entry ID (required)
format: Response format (json, markdown)

Returns: Time entry details.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Time entry ID"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshdesk_create_time_entry

Create a new time entry on a ticket.

Args:

ticket_id: Ticket ID (required)
time_spent: Time spent string (e.g., "01:30" for 1h 30m) (required)
agent_id: Agent ID (defaults to authenticated agent)
billable: Is billable
note: Note text
executed_at: When the time was spent (ISO 8601)

Returns: The created time entry.

{
  "type": "object",
  "required": [
    "ticket_id",
    "time_spent"
  ],
  "properties": {
    "note": {
      "type": "string"
    },
    "agent_id": {
      "type": "integer"
    },
    "billable": {
      "type": "boolean"
    },
    "ticket_id": {
      "type": "integer",
      "description": "Ticket ID"
    },
    "time_spent": {
      "type": "string",
      "description": "Time spent (e.g., \"01:30"
    },
    "executed_at": {
      "type": "string"
    }
  }
}

freshdesk_create_ticket

Create a new support ticket.

Args:

subject: Ticket subject (required)
description: Ticket description in HTML (required)
email: Requester email (required if no requester_id)
requester_id: Requester contact ID (alternative to email)
status: Ticket status (2=Open, 3=Pending, 4=Resolved, 5=Closed)
priority: Ticket priority (1=Low, 2=Medium, 3=High, 4=Urgent)
type: Ticket type (e.g., Question, Incident, Problem)
source: Ticket source (1=Email, 2=Portal, 3=Phone, 7=Chat)
responder_id: Agent ID to assign
group_id: Group ID to assign
product_id: Product ID
tags: Array of tags
cc_emails: Array of CC email addresses

Returns: The created ticket with its ID and details.

{
  "type": "object",
  "required": [
    "subject",
    "description"
  ],
  "properties": {
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of tags"
    },
    "type": {
      "type": "string",
      "description": "Ticket type"
    },
    "email": {
      "type": "string",
      "description": "Requester email"
    },
    "source": {
      "type": "integer",
      "description": "Source: 1=Email, 2=Portal, 3=Phone, 7=Chat"
    },
    "status": {
      "type": "integer",
      "maximum": 7,
      "minimum": 2,
      "description": "Status: 2=Open, 3=Pending, 4=Resolved, 5=Closed"
    },
    "subject": {
      "type": "string",
      "description": "Ticket subject"
    },
    "group_id": {
      "type": "integer",
      "description": "Group ID to assign"
    },
    "priority": {
      "type": "integer",
      "maximum": 4,
      "minimum": 1,
      "description": "Priority: 1=Low, 2=Medium, 3=High, 4=Urgent"
    },
    "cc_emails": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "CC email addresses"
    },
    "product_id": {
      "type": "integer",
      "description": "Product ID"
    },
    "description": {
      "type": "string",
      "description": "Ticket description (HTML)"
    },
    "requester_id": {
      "type": "integer",
      "description": "Requester contact ID"
    },
    "responder_id": {
      "type": "integer",
      "description": "Agent ID to assign"
    }
  }
}

freshdesk_update_ticket

Update an existing ticket.

Args:

id: Ticket ID (required)
subject: New subject
description: New description (HTML)
status: New status (2=Open, 3=Pending, 4=Resolved, 5=Closed)
priority: New priority (1=Low, 2=Medium, 3=High, 4=Urgent)
type: New ticket type
responder_id: New agent ID
group_id: New group ID
tags: New tags array

Returns: The updated ticket.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Ticket ID"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "type": {
      "type": "string"
    },
    "status": {
      "type": "integer",
      "maximum": 7,
      "minimum": 2,
      "description": "Status: 2=Open, 3=Pending, 4=Resolved, 5=Closed"
    },
    "subject": {
      "type": "string"
    },
    "group_id": {
      "type": "integer"
    },
    "priority": {
      "type": "integer",
      "maximum": 4,
      "minimum": 1,
      "description": "Priority: 1=Low, 2=Medium, 3=High, 4=Urgent"
    },
    "product_id": {
      "type": "integer"
    },
    "description": {
      "type": "string"
    },
    "responder_id": {
      "type": "integer"
    }
  }
}

freshdesk_delete_ticket

Delete a ticket (moves to trash).

Args:

id: Ticket ID (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Ticket ID"
    }
  }
}

freshdesk_restore_ticket

Restore a deleted ticket from trash.

Args:

id: Ticket ID (required)

Returns: Confirmation of restoration.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Ticket ID"
    }
  }
}

freshdesk_search_tickets

Search for tickets using Freshdesk's search query syntax.

Args:

query: Search query (e.g., "priority:4", "status:2", "tag:'urgent'")
page: Page number (1-10, max 300 results)
format: Response format (json, markdown)

Returns: Matching tickets and total count.

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "maximum": 10,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "description": "Search query"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string"
    }
  }
}

freshdesk_reply_to_ticket

Reply to a ticket (sends email to requester).

Args:

ticket_id: Ticket ID (required)
body: Reply body in HTML (required)
cc_emails: CC email addresses
bcc_emails: BCC email addresses

Returns: The created conversation.

{
  "type": "object",
  "required": [
    "ticket_id",
    "body"
  ],
  "properties": {
    "body": {
      "type": "string",
      "description": "Reply body (HTML)"
    },
    "cc_emails": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "ticket_id": {
      "type": "integer",
      "description": "Ticket ID"
    },
    "bcc_emails": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}

freshdesk_add_note

Add a note to a ticket.

Args:

ticket_id: Ticket ID (required)
body: Note body in HTML (required)
private: Whether note is private (default: true)
notify_emails: Email addresses to notify

Returns: The created note.

{
  "type": "object",
  "required": [
    "ticket_id",
    "body"
  ],
  "properties": {
    "body": {
      "type": "string",
      "description": "Note body (HTML)"
    },
    "private": {
      "type": "boolean",
      "default": true,
      "description": "Is note private?"
    },
    "ticket_id": {
      "type": "integer",
      "description": "Ticket ID"
    },
    "notify_emails": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}

freshdesk_delete_conversation

Delete a conversation (note or reply).

Args:

id: Conversation ID (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Conversation ID"
    }
  }
}

freshdesk_list_time_entries

List time entries from Freshdesk with pagination and filtering.

Args:

page: Page number (default: 1)
per_page: Entries per page (1-100, default: 30)
billable: Filter by billable status
agent_id: Filter by agent ID
executed_after: Filter entries executed after this date
executed_before: Filter entries executed before this date
format: Response format (json, markdown)

Returns: List of time entries.

{
  "type": "object",
  "properties": {
    "page": {
      "type": "integer",
      "default": 1,
      "minimum": 1,
      "description": "Page number"
    },
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "agent_id": {
      "type": "integer",
      "description": "Filter by agent ID"
    },
    "billable": {
      "type": "boolean",
      "description": "Filter by billable"
    },
    "per_page": {
      "type": "integer",
      "default": 30,
      "maximum": 100,
      "minimum": 1,
      "description": "Entries per page"
    },
    "executed_after": {
      "type": "string",
      "description": "Filter after this date"
    },
    "executed_before": {
      "type": "string",
      "description": "Filter before this date"
    }
  }
}

freshdesk_list_ticket_time_entries

List time entries for a specific ticket.

Args:

ticket_id: Ticket ID (required)
format: Response format (json, markdown)

Returns: List of time entries on the ticket.

{
  "type": "object",
  "required": [
    "ticket_id"
  ],
  "properties": {
    "format": {
      "enum": [
        "json",
        "markdown"
      ],
      "type": "string",
      "default": "json",
      "description": "Response format"
    },
    "ticket_id": {
      "type": "integer",
      "description": "Ticket ID"
    }
  }
}

freshdesk_update_time_entry

Update an existing time entry.

Args:

id: Time entry ID (required)
time_spent: New time spent string
billable: New billable status
note: New note
executed_at: New executed date

Returns: The updated time entry.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Time entry ID"
    },
    "note": {
      "type": "string"
    },
    "billable": {
      "type": "boolean"
    },
    "time_spent": {
      "type": "string"
    },
    "executed_at": {
      "type": "string"
    }
  }
}

freshdesk_delete_time_entry

Delete a time entry.

Args:

id: Time entry ID (required)

Returns: Confirmation of deletion.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Time entry ID"
    }
  }
}

freshdesk_toggle_timer

Toggle the timer on a time entry (start/stop).

Args:

id: Time entry ID (required)

Returns: The updated time entry with timer status.

{
  "type": "object",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "description": "Time entry ID"
    }
  }
}