Omni MCP server
✓ VerifiedProvides a unified suite of tools for GitHub, local Git, Slack, web fetching, persistent memory, and filesystem access in a single configuration.
Also known as bitofacoder/omni-mcp-server, @bitofacoder/omni-mcp-server
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- 211
- Latest version
- 1.1.1
- Last commit
- Jun 10, 2026
- License
- MIT
What is Omni MCP?
Omni provides a unified suite of tools for GitHub, local Git, Slack, web fetching, persistent memory, and filesystem access in a single configuration.
Summary generated from the project's README
About Omni MCP server
Managing multiple MCP configurations for different tasks is what omni-mcp-server simplifies by bundling six distinct capabilities into a single setup. Developers can access GitHub, local Git, Slack, web fetching, persistent memory, and filesystem tools through one npx command. This server runs locally on your machine via stdio, ensuring your data remains private. You provide your own GitHub and Slack tokens through environment variables to enable those specific integrations.
Security is a priority because dangerous capabilities like system_execute_command and system_write_file are disabled by default. These tools only become available if you explicitly opt into Agent Mode by setting the OMNI_AGENT_MODE environment variable to true. Without this setting, the server provides read-only or sandboxed access, such as using web_fetch to pull Markdown from URLs or memory_store to save preferences across different chat sessions.
What you can do with it
- 1Consolidate multiple MCP configurationsReplace several individual server setups with a single configuration entry for all your developer tools.
- 2Automate local development workflowsAllow an AI client to run shell commands and edit files by enabling Agent Mode.
- 3Maintain context across chat sessionsInstruct an AI to remember specific notes or user preferences for future interactions.
- 4Retrieve information from the webAsk an AI to read the content of a public website and convert it to Markdown.
Written from the project's README. Every use case is checked against a quote from it.
How to install Omni MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Omni MCP in Claude Code
$ claude mcp add --env 'GITHUB_PERSONAL_ACCESS_TOKEN=<YOUR_GITHUB_PERSONAL_ACCESS_TOKEN>' --env 'SLACK_BOT_TOKEN=<YOUR_SLACK_BOT_TOKEN>' omni-mcp-server -- npx -y @bitofacoder/omni-mcp-serverInstall Omni MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"omni-mcp-server": {
"command": "npx",
"args": [
"-y",
"@bitofacoder/omni-mcp-server"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_GITHUB_PERSONAL_ACCESS_TOKEN>",
"SLACK_BOT_TOKEN": "<YOUR_SLACK_BOT_TOKEN>"
}
}
}
}Install Omni MCP in VS Code
.vscode/mcp.json
{
"servers": {
"omni-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@bitofacoder/omni-mcp-server"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_GITHUB_PERSONAL_ACCESS_TOKEN>",
"SLACK_BOT_TOKEN": "<YOUR_SLACK_BOT_TOKEN>"
}
}
}
}Install Omni MCP in VS Code CLI
$ code --add-mcp '{"name":"omni-mcp-server","type":"stdio","command":"npx","args":["-y","@bitofacoder/omni-mcp-server"],"env":{"GITHUB_PERSONAL_ACCESS_TOKEN":"<YOUR_GITHUB_PERSONAL_ACCESS_TOKEN>","SLACK_BOT_TOKEN":"<YOUR_SLACK_BOT_TOKEN>"}}'Install Omni MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"omni-mcp-server": {
"command": "npx",
"args": [
"-y",
"@bitofacoder/omni-mcp-server"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_GITHUB_PERSONAL_ACCESS_TOKEN>",
"SLACK_BOT_TOKEN": "<YOUR_SLACK_BOT_TOKEN>"
}
}
}
}Install Omni MCP in Codex
$ codex mcp add omni-mcp-server --env 'GITHUB_PERSONAL_ACCESS_TOKEN=<YOUR_GITHUB_PERSONAL_ACCESS_TOKEN>' --env 'SLACK_BOT_TOKEN=<YOUR_SLACK_BOT_TOKEN>' -- npx -y @bitofacoder/omni-mcp-serverInstall Omni MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.omni-mcp-server] command = "npx" args = ["-y", "@bitofacoder/omni-mcp-server"] [mcp_servers.omni-mcp-server.env] GITHUB_PERSONAL_ACCESS_TOKEN = "<YOUR_GITHUB_PERSONAL_ACCESS_TOKEN>" SLACK_BOT_TOKEN = "<YOUR_SLACK_BOT_TOKEN>"
Install Omni MCP in Gemini CLI
$ gemini mcp add -s user -e 'GITHUB_PERSONAL_ACCESS_TOKEN=<YOUR_GITHUB_PERSONAL_ACCESS_TOKEN>' -e 'SLACK_BOT_TOKEN=<YOUR_SLACK_BOT_TOKEN>' omni-mcp-server npx -- -y @bitofacoder/omni-mcp-serverInstall Omni MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"omni-mcp-server": {
"command": "npx",
"args": [
"-y",
"@bitofacoder/omni-mcp-server"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_GITHUB_PERSONAL_ACCESS_TOKEN>",
"SLACK_BOT_TOKEN": "<YOUR_SLACK_BOT_TOKEN>"
}
}
}
}Configuration
GITHUB_PERSONAL_ACCESS_TOKENSecretGitHub token for the GitHub tools (optional)
SLACK_BOT_TOKENSecretSlack bot token for slack_send_message (optional)
OMNI_AGENT_MODESet to 'true' to enable Agent Mode (shell execution and file writes). Disabled by default.
| Name | Description | |
|---|---|---|
| GITHUB_PERSONAL_ACCESS_TOKEN | GitHub token for the GitHub tools (optional) | Secret |
| SLACK_BOT_TOKEN | Slack bot token for slack_send_message (optional) | Secret |
| OMNI_AGENT_MODE | Set to 'true' to enable Agent Mode (shell execution and file writes). Disabled by default. |
Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablebitofacoder/omni-mcp-server is public and reachablegithub.com/bitofacoder/omni-mcp-server ↗Pass
- Package names this repository as its source@bitofacoder/omni-mcp-server names bitofacoder/omni-mcp-server as sourcenpmjs.com/package/@bitofacoder/omni-mcp-server ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-06-10github.com/bitofacoder/omni-mcp-server ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @bitofacoder/omni-mcp-serverPass
- No critical advisory in the package or its dependencies161 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubOmni MCP Server 🚀
One MCP server instead of six. GitHub, local Git, Slack, web fetching, persistent memory, and filesystem tools — 15 tools in a single config entry, with dangerous capabilities off by default.

Why Omni?
Setting up MCP usually means installing and configuring a separate server for every capability — one for GitHub, one for filesystem, one for memory, one for fetch. Each has its own config block, its own runtime, its own startup cost.
Omni bundles the everyday developer tools into one server, one config entry, one npx command:
| You'd normally install… | With Omni |
|---|---|
server-github |
✅ built in |
server-filesystem |
✅ built in |
server-memory |
✅ built in |
server-fetch |
✅ built in |
| a git server | ✅ built in |
| a Slack server | ✅ built in |
- 🔒 Safe by default — shell execution and file writes are disabled unless you explicitly opt in to Agent Mode.
- 🏠 Local & private — runs on your machine over stdio. You bring your own tokens; nothing is proxied through a third party.
- 🪶 Zero install — runs straight from npm via
npx.
🚀 Quick Start
Interactive setup (Claude Desktop)
npx -y @bitofacoder/omni-mcp-server@latest setup
The wizard asks for your optional tokens (GitHub, Slack), asks whether to enable Agent Mode, and updates your Claude Desktop config for you. Restart Claude Desktop and you're done.
Claude Code
claude mcp add omni -e GITHUB_PERSONAL_ACCESS_TOKEN=your_gh_token -- npx -y @bitofacoder/omni-mcp-server@latest
Manual config (Claude Desktop, Cursor, Windsurf, Codex CLI…)
Add this to your client's MCP config (e.g. claude_desktop_config.json):
{
"mcpServers": {
"omni": {
"command": "npx",
"args": ["-y", "@bitofacoder/omni-mcp-server@latest"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "your_gh_token",
"SLACK_BOT_TOKEN": "your_slack_token"
}
}
}
}
All env vars are optional — tools that need a missing token simply tell you so.
🛠️ Tools (15)
| Group | Tool | What it does |
|---|---|---|
| 🐙 GitHub | github_search_repos |
Search GitHub repositories |
github_get_issue |
Get details of a specific issue | |
| 🌳 Local Git | git_status |
Working tree + staging area status |
git_diff |
View local code changes | |
git_log |
View commit history | |
git_commit |
Commit staged changes with a message | |
| 💻 System | system_read_file |
Read a local file |
system_list_dir |
List a directory | |
system_write_file |
⚠️ Write a file (Agent Mode only) | |
system_execute_command |
⚠️ Run a shell command (Agent Mode only) | |
| 🌐 Web | web_fetch |
Fetch any public URL as clean Markdown — no API key needed |
| 🧠 Memory | memory_store |
Save a note/preference across chats |
memory_retrieve |
Retrieve a saved memory | |
memory_list |
List everything remembered | |
| 💬 Slack | slack_send_message |
Send a message to a Slack channel |
🔒 Agent Mode (opt-in)
system_execute_command and system_write_file let the AI act on your machine — run tests, install packages, edit files. Because that's real power, they are disabled by default and don't even appear in the tool list until you enable them:
"env": {
"OMNI_AGENT_MODE": "true"
}
Everything else (reading files, git status, web fetch, memory) is read-only or sandboxed to its own data file.
🤝 Contributing
PRs welcome — especially new integrations (Linear, Notion, Jira, Discord) and Agent Mode hardening (allowlists, working-dir scoping). Open an issue first for bigger changes.
If Omni saved you some config wrangling, a ⭐ helps other people find it.
📄 License
MIT — see LICENSE.
Omni MCP questions
How do I add Omni MCP to Claude Code?
Run claude mcp add --env 'GITHUB_PERSONAL_ACCESS_TOKEN=<YOUR_GITHUB_PERSONAL_ACCESS_TOKEN>' --env 'SLACK_BOT_TOKEN=<YOUR_SLACK_BOT_TOKEN>' omni-mcp-server -- npx -y @bitofacoder/omni-mcp-server in your terminal. Add --scope user to make it available in every project.
How do I add Omni MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Is it safe to run commands and write files with this server?
Shell execution and file writes are disabled by default and require you to explicitly opt in to Agent Mode.
Do I need to install anything to use Omni?
No, it runs directly from npm using the npx command.
How do I enable the ability to run shell commands and edit files?
You must enable Agent Mode by setting the OMNI_AGENT_MODE environment variable to true.
Does web fetching require an API key?
No, the web fetch tool can retrieve any public URL as Markdown without an API key.