How to integrate Freshservice MCP with Codex

Connect Codex to Freshservice MCP. List all open tickets in freshservice, create a new incident ticket for laptop issue, and more using natural language, with authentication handled for you.

Freshservice logoFreshservice
Api Key

Freshservice is a cloud-based IT service management (ITSM) platform for incident, asset, and service desk operations. Streamline your IT support with automation and centralized control.

20 Tools

Introduction

Codex is one of the most popular coding harnesses out there. And MCP makes the experience even better. With the Freshservice MCP integration, Codex can create tickets and service requests, list and bulk update tickets, browse the service catalog, and clean up old solution articles, all without leaving the terminal or the app, whichever you prefer.

Also integrate Freshservice with

Why use Composio?

Apart from a managed and hosted MCP server, you will get:

  • CodeAct: A dedicated workbench that allows GPT to write its code to handle complex tool chaining. Reduces to-and-fro with LLMs for frequent tool calling.
  • Large tool responses: Handle them to minimise context rot.
  • Dynamic just-in-time access to 20,000 tools across 1700+ other Apps for cross-app workflows. It loads the tools you need, so GPTs aren't overwhelmed by tools you don't need.

How to install Freshservice MCP in Codex

Run the setup command

Run this command in your terminal to add the Composio MCP server to Codex.

Terminal

It will initiate the authentication in a browser window, authorize Codex to access your Composio account.

Composio authentication page

(Optional) Authenticate with OAuth

To authenticate manually, run the login command to open a browser window and authorize Codex to access your Composio account.

bash
codex mcp login composio

Verify the connection

Run codex mcp list to confirm Composio appears as a registered MCP server.

bash
codex mcp list

Codex App

Codex App follows the same approach as VS Code.

  1. Click ⚙️ on the bottom left → MCP Servers → + Add servers → Streamable HTTP:
  2. Fill the header and Key fields with { "x-consumer-api-key" = "ck_*******" }.
  3. The Key is the Composio API key, that you can find on dashboard.composio.dev
  4. Click on Authenticate and authorize Codex to your Composio account and you're all set.
Codex App MCP setup
  1. Restart and verify if it's there in .codex/config.toml
bash
[mcp_servers.composio]
url = "https://connect.composio.dev/mcp"
http_headers = { "x-consumer-api-key" = "ck_*******" }

Try it

Ask Codex for a Freshservice task. The first time, Composio asks you to connect your Freshservice account.

For example, ask it to:

  • "List all open tickets in Freshservice"
  • "Create a new incident ticket for laptop issue"
  • "Update ticket status to resolved for #12345"

What is the Freshservice MCP server, and what's possible with it?

The Freshservice MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Freshservice account. It provides structured and secure access to tickets, service catalog items, locations, and form fields, so your agent can create tickets, retrieve ticket details, update multiple tickets, submit service requests, and list locations on your behalf.

  • Ticket creation and tracking: Have your agent create new support tickets, list existing tickets, or retrieve the details of a specific ticket.
  • Bulk ticket updates: Direct your agent to update multiple Freshservice tickets when priorities, statuses, or other ticket details need to change.
  • Service catalog requests: Let the agent browse available service catalog items and submit a service request for the item you need.
  • Location and form field lookup: Instruct your agent to list Freshservice locations or retrieve the available fields for problem and release forms.
  • Release and knowledge base cleanup: Have your agent delete releases, solution articles, or solution categories that are no longer needed.

Conclusion

You've successfully integrated Freshservice with Codex using Composio's MCP server. Now you can interact with Freshservice directly from your terminal, VS Code, or the Codex App using natural language commands.

Key benefits of this setup:

  • Seamless integration across CLI, VS Code, and standalone app
  • Natural language commands for Freshservice operations
  • Managed authentication through Composio
  • Access to 20,000+ tools across 1700+ apps for cross-app workflows
  • CodeAct workbench for complex tool chaining

Next steps:

  • Try asking Codex to perform various Freshservice operations
  • Explore cross-app workflows by connecting more toolkits
  • Build automation scripts that leverage Codex's AI capabilities
TOOLS

Supported Tools

Every Freshservice action and event your agent gets out of the box.

Bulk Update Tickets

Updates the same supplied fields on multiple Freshservice tickets identified by ID, using sequential requests.

Create Service Request

Create a service request for a catalog item in Freshservice using the v2 API.

Create Ticket

Create a new Freshservice ticket to log an incident.

Delete Release

Deletes a release from Freshservice.

Delete Solution Article

Deletes a Freshservice knowledge base solution article by ID, moving it to Trash where it can be restored.

Delete Solution Category

Deletes a Freshservice solution category, moving it and its associated folders and articles to Trash.

Get Freshservice Agent

Retrieve one Freshservice support agent profile by its numeric user ID.

Get Problem Form Fields by Workspace

Lists Freshservice problem form field definitions for a specified workspace.

List Release Form Fields

Lists Freshservice release form field definitions for building or validating release forms.

Get Freshservice Requester

Retrieve one Freshservice requester profile by its numeric user ID.

Get Service Catalog Item

Retrieve a service catalog item's details and request form by display ID.

Get Freshservice Ticket

Retrieve a specific Freshservice ticket by ID, including its status, priority, requester ID, and other supported attributes.

List Freshservice Agents

Return Freshservice support agents page by page.

List Freshservice Locations

Lists a page of Freshservice locations, with a choice of page number and page size.

List Project Tasks

Return a page of tasks belonging to one Freshservice project.

List Service Catalog Items

Requests a page of Freshservice service catalog items to help identify items and their display IDs for service requests.

List Ticket Approvals

Return approvals and their current participants for a service request.

List Ticket Conversations

Return a page of replies and notes on one Freshservice ticket.

List Freshservice Tickets

List Freshservice tickets with optional predefined filtering and pagination; on accounts with workspaces, results are limited to the primary workspace.

Search Tickets

Search Freshservice tickets using the provider's filter expression syntax.

FAQ

Frequently asked questions

With a standalone Freshservice MCP server, the agents and LLMs can only access a fixed set of Freshservice tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Freshservice and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Codex fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Freshservice tools.

Yes, absolutely. You can configure which Freshservice scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Freshservice data and credentials are handled as safely as possible.

Start with Freshservice.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Freshservice tool your agent needs.Free to start.

Start building