causly-server MCP server
io.github.KNIHAL · Updated
Open-source MCP server that turns any AI agent into your technical co-founder
At a glance
causly-server is an MCP server in the Dev Tools & Git category. It runs locally over stdio via `npx -y causly-server`, and declares no required credentials. It exposes 4 tools, including ship_change, fix_ci and verify_ci_fix. It scores A (81/100) on the MCP Skills Hub health score as of Oct 27, 2026.
One-click install
Opens your editor and pre-fills the config. Your editor will ask before adding it.
How to install causly-server in your AI client
Setup for Claude Code, Claude Desktop, Cursor, Codex, Windsurf, Cline and VS Code — copy-paste ready.
How to install causly-server in Claude CodeAnthropic's agentic CLI
Add the server
bashclaude mcp add causly-server -- npx -y causly-serverVerify it's connected
bashclaude mcp listSharing it with your team?
Add `--scope project` to write it to .mcp.json in the repository root, which you can commit (with the secrets left as environment variables).
Use it in a session
Ask Claude to use the tools this server exposes (e.g. ship_change, fix_ci, verify_ci_fix). It discovers them automatically.
How to install causly-server in Claude DesktopDesktop app (MCP config)
Open your MCP config
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json
Add this server
json{ "mcpServers": { "causly-server": { "command": "npx", "args": [ "-y", "causly-server" ] } } }Restart Claude Desktop
The tools appear under the 🔌 menu once the app reloads.
How to install causly-server in CursorAI-first code editor
Create / edit .cursor/mcp.json in your project
json{ "mcpServers": { "causly-server": { "command": "npx", "args": [ "-y", "causly-server" ] } } }Enable it
Cursor Settings → MCP → toggle the server on. Tools become available to the Composer/Agent.
How to install causly-server in Codex CLIOpenAI coding agent
Add to ~/.codex/config.toml
toml[mcp_servers.causly-server] command = "npx" args = ["-y", "causly-server"]Run Codex
Codex loads MCP servers from config.toml on startup and exposes their tools to the agent.
How to install causly-server in WindsurfCodeium's agentic IDE
Edit ~/.codeium/windsurf/mcp_config.json
json{ "mcpServers": { "causly-server": { "command": "npx", "args": [ "-y", "causly-server" ] } } }Reload
Windsurf → Cascade → refresh MCP servers. Cascade can now call the tools.
How to install causly-server in ClineVS Code autonomous agent
Open Cline → MCP Servers → Configure
Adds to cline_mcp_settings.json.
Add the server
json{ "mcpServers": { "causly-server": { "command": "npx", "args": [ "-y", "causly-server" ] } } }
How to install causly-server in VS CodeCopilot / MCP support
Create .vscode/mcp.json
json{ "servers": { "causly-server": { "type": "stdio", "command": "npx", "args": [ "-y", "causly-server" ] } } }Start it
VS Code shows a ▶ Start action above the server entry. Agent mode (Copilot Chat) can then use the tools.
What tools does causly-server expose? (4)
Taken from the project's README — the server itself was not queried, so check its docs for the exact schemas.
- ship_changeinspects changes, creates a branch, runs project checks, commits, pushes and opens a pull request.
- fix_cifinds a failing GitHub Actions run and fetches the real failure output.
- verify_ci_fixcommits and pushes the fix, polls the workflow and confirms CI is green.
- deploy_projectchecks health, runs tests and build, deploys, polls, and HTTP-verifies the live URL.
What the code can do
Read from the published package source — never executed. Parsed 80 of 85 source files.
This server can run other programs on your machine, read and write files and make network requests.
How it was published
- No provenance attestation — there is nothing linking this published artifact to a specific source commit.
- 1 npm maintainer — a single point of compromise · last published by knihal.
Maintainer of this package and think something here is wrong? Tell us and we'll correct it.
Before you install
Signals gathered from the source repo and package registry — not a safety verdict.
What it can reach
- Runs code on your machine — Executes as a local process with your user's permissions, including filesystem access.
- Downloads at launch — The package is fetched from its registry each run unless you pin a version.
- Last commit today — Actively maintained.
- 1 GitHub stars — Very little community usage so far.
- 0 weekly downloads — Very few installs — you would be an early user.
Client compatibility
Health score
A · 81Maintenance, adoption, transparency and packaging — not a safety audit. How this is calculated
- Maintenance30%100%
Last commit 0 days ago.
- Adoption20%5%
1 stars, 0 weekly downloads.
- Transparency20%100%
4/4: ✓ public source repo, ✓ declared license, ✓ documentation, ✓ discoverable tool list.
- Provenance15%100%
Package and registry entry point at the same repository.
- Packaging15%100%
Publishes a pinned version (1.5.3).
Documentation
Full READMECausly Server
The open-source MCP server that turns any AI agent into your technical co-founder.
Most agents can write text. Causly Server gives them hands: they ship code, hunt for clients, track deals, take meeting notes, handle your calendar and remind you on Telegram, all from one conversation, all on your own machine.
npm install -g causly-server
causly-server initContents
- Why Causly Server
- Quick start
- What you can ask
- How it works
- Tool packs
- Workflow tools
- Configuration
- Google setup
- Works with
- Security and privacy
- Command reference
- Troubleshooting
- FAQ
- Compatibility
- Contributing, roadmap, license
Why Causly Server
A founder's week is not only code. It is also finding clients, following up, remembering what was promised in a call, and shipping without breaking things. Causly Server puts all of that behind one MCP server.
- One server for build, sell, operate and grow. Git, GitHub, CI and deploys, but also leads, a sales pipeline, meeting notes, calendar, reminders and SEO.
- Memory that survives the chat. Your pipeline, meetings and reminders live in a local SQLite file, so the agent can pick up tomorrow where it stopped today.
- Local-first. Keys and data stay on your machine. There is no Causly cloud in the loop.
- Safe by default. Risky actions need explicit confirmation, file access can be limited to one folder, and secrets are redacted from logs.
- Light on your agent's context. Tools load in packs on demand instead of flooding the agent with hundreds of definitions.
- One command setup.
initfinds Claude Desktop, Cursor and Windsurf and wires them up.
Quick start
Requires Node.js 20 or newer.
1. Install
npm install -g causly-server2. Connect your editors
Excerpt — the full document is on GitHub.
Alternatives to causly-server
- Agent-Native CalendarA · 88Agent-Native Google Calendar - manage events, sync, and public booking
- Gmail-MCP-ServerA · 87Lean Gmail MCP server with auto authentication support
- gdharnessA · 88A harness for driving a Godot 4 project from an agent: addons, runtime bridge, MCP server, CLI.
- Vibe Test — Browser Testing AgentA · 88Code-aware browser testing agent — 14 Playwright tools for AI code editors via MCP
Maintain causly-server? Add a badge to your README
Shows its health grade, and links readers to install steps for every client.
[](https://mcp-skills-hub.vercel.app/mcps/io-github-knihal-causly-server)Catalog data refreshed . Something wrong? Report it.