anggasct/mcp-insomnia

MCP-Insomnia is an MCP (Model Context Protocol) server that enables AI agents to create and manage API collections in Insomnia-compatible format. This server provides tools for managing collections, requests, and environments that can be exported to Insomnia.
## Installation and Usage
### Prerequisites
Node.js 18+
npm or yarn
There are three ways to use mcp-insomnia.
### 1. Run with NPX (Recommended)
You can run mcp-insomnia directly using npx without a global installation.
Configuration:
json
"mcpServers": {
"insomnia": {
"command": "npx",
"args": ["-y", "mcp-insomnia"]
### 2. Install Globally from NPM
Install the package globally using npm.
Installation:
bash
npm install -g mcp-insomnia
Configuration:
json
"mcpServers": {
"insomnia": {
"command": "mcp-insomnia"
### 3. Install from Source
Clone the repository and build the project.
Installation:
bash
git clone https://github.com/anggasct/mcp-insomnia.git
cd mcp-insomnia
npm install
npm run build
Configuration:
json
"mcpServers": {
"insomnia": {
"command": "node",
"args": ["/path/to/mcp-insomnia/dist/index.js"]
## Available Tools
### Collection Management
createcollection - Create new collection/workspace
listcollections - List all collections
getcollectiondetail - Get full details and statistics of a collection
exportcollection - Export collection to JSON format
### Folder Management
createfolder - Create folder within collection
### Request Management
listrequests - List all requests, optionally filter by collection
getrequest - Get full details of a specific request
createrequestincollection - Create new request
updaterequest - Update existing request
deleterequest - Delete request
executerequest - Execute an MCP-stored request and return the response (supports environment resolution, timeouts, and response size limits — see Request execution)
getrequesthistory - Get execution history of a request (up to 20 entries per request)
### Import Tools
importfromcurl - Parse cURL command into a request
importfrompostman - Import Postman Collection (v2.1) JSON
importfromopenapi - Import OpenAPI 3.x or Swagger 2.x JSON
importfrominsomniaexport - Import collections from a standard Insomnia V4 export file
### Utility Tools
generatecodesnippet - Generate a code snippet for a request. Requires requestId and target. Supported targets: c, clojure, csharp, go, http, java, javascript, kotlin, node, objc, ocaml, php, powershell, python, ruby, shell, swift. Optional client selects a library (e.g. axios for javascript, curl for shell).
### Insomnia Direct Integration (NeDB)
Interact directly with the local Insomnia application database (macOS, Linux, Windows).
listinsomniaprojects - List all projects/teams from Insomnia
listinsomniacollections - List all workspaces/collections from Insomnia
getinsomniacollection - Get full details of a specific Insomnia workspace
getinsomniarequest - Get full details of a specific Insomnia request
syncfrominsomnia - Import a workspace from Insomnia to MCP
syncallfrominsomnia - Import all workspaces from Insomnia to MCP
synctoinsomnia - Export an MCP collection back to Insomnia
executeinsomniarequest - Execute a request directly from Insomnia without syncing (supports environment resolution and timeouts — see Request execution)