yaak-mcp
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
yaak-mcp
An MCP server for Yaak that adds environment management. It replaces the
deprecated @yaak/mcp-server plugin and runs over stdio by calling the yaak CLI, so it works
whether or not the app is open. Changes appear in a running Yaak window within about a second.
Requirements
Yaak CLI 2026.9.1 or later:
mise use -g npm:@yaakapp/cli@latestNode 22+ (pinned in
mise.toml)
Related MCP server: Relay
Install
Published to npm as @codezninja/yaak-mcp.
For Claude Code:
claude mcp add -s user yaak -- npx -y @codezninja/yaak-mcpFor Claude Desktop, add this to ~/Library/Application Support/Claude/claude_desktop_config.json
and restart Desktop. Desktop doesn't load your shell profile, so use absolute paths if npx or
yaak aren't on its PATH (or set YAAK_BIN):
{
"mcpServers": {
"yaak": {
"command": "npx",
"args": ["-y", "@codezninja/yaak-mcp"]
}
}
}Development
mise run deps
mise run build
mise run check # typecheck + unit testsTo run a local build, point the MCP client at node <repo>/dist/index.js.
Releasing
Bump
versioninpackage.json(npm version patch --no-git-tag-version), commit and push.Publish a GitHub Release with tag
v<version>, e.g.gh release create v0.1.1 --generate-notes. Mark it as a pre-release to stage it under thenextdist-tag.Approve the staged version on npmjs.com (package settings) or with
npm stage approve <id>. Approval needs 2FA.
The Publish workflow checks the tag matches package.json, runs the checks, and runs
npm stage publish with npm trusted publishing (OIDC). The trusted publisher is stage-only, so
nothing goes live without a maintainer's approval, and no npm token is stored in the repo.
Tools
Same names as the old plugin, so existing prompts keep working:
list_workspaceslist_http_requests,get_http_request,create_http_request,update_http_request,delete_http_request,send_http_requestlist_folders,get_folder,create_folder,update_folder,delete_folder
New:
list_environmentslists environments with their kind (base,sub,folder) and variable names. Values are left out.get_environmentreturns one environment with all variables and values.create_environmentcreates a sub-environment, or a folder environment whenfolderIdis given.update_environmentchanges name, color,publicor the whole variable list.delete_environmentdeletes a sub or folder environment. It refuses the base environment.set_environment_variableadds or changes one variable, leaving the rest alone.remove_environment_variableremoves one variable by name.
Differences from the plugin
No
show_toast,get_workspace_idorget_environment_id. Those read the app window, which the CLI can't see.send_http_requestcan't use the environment selected in the app. PassenvironmentId; without it only base and folder variables apply.With more than one workspace, tools that take
workspaceIdneed it.update_*tools send a JSON merge patch: fields you pass change, and arrays you pass (headers, variables) replace the stored ones.
Configuration
Variable | Default | Purpose |
|
| Path to the Yaak CLI |
| CLI default | Passed as |
|
| Timeout for each CLI call |
|
| Timeout for |
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Manage uivoid projects, tools, keys, hosted databases and teams from your agent.
Develop, manage, and debug Railway projects, services, and deployments from within agents.
Manage PocketBase Cloud projects, instances, deploys, domains, collections and records.
Build and publish pages, manage collections, records and files in a Markerloop workspace.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to interact with Istek API Client for managing workspaces, collections, environments, variables, and request history. Allows natural language control of API development workflows including creating collections, adding requests, and managing environment configurations.-
- AlicenseNot gradedqualityDmaintenanceA keyboard-first API client that stores requests and environments as plain files, and exposes its workspace over MCP so agents can browse, send, and create requests with vault access.MIT
- AlicenseNot gradedqualityAmaintenanceEnables AI clients such as Claude, Cursor, VS Code, and Windsurf to manage workspaces, projects, tasks, and AI agents through hosted OAuth or local stdio tools.2,530 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables AI clients such as Claude, Cursor, VS Code, and Windsurf to manage workspaces, projects, tasks, AI agents, automations, and files via the Model Context Protocol, with hosted OAuth or local stdio options.2,530 npmMIT