nickgnd_tmux_mcp
by nickgndLicense
You signed in with another tab or window. Reload
to refresh your session. You signed out in another tab or window. Reload
to refresh your session. You switched accounts on another tab or window. Reload
to refresh your session. Dismiss alert
- Notifications
You must be signed in to change notification settings
A MCP server for our beloved terminal multiplexer tmux.
License
7 stars
1 fork
Branches
Tags
Activity
Notifications
You must be signed in to change notification settings
nickgnd/tmux-mcp
main
Go to file
Code
Folders and files
| Name | | Name | Last commit message | Last commit date |
| --- | --- | --- | --- |
| Latest commit
-------------
nickgnd
chore: add link to youtube video
Mar 24, 2025
05b6d71
· Mar 24, 2025
History
-------
22 Commits
| | |
| src | | src | chore: increase captured content when retrieve command result | Mar 24, 2025 |
| .gitignore | | .gitignore | chore: add basic interfaces | Mar 6, 2025 |
| LICENSE.md | | LICENSE.md | chore: add MIT license | Mar 13, 2025 |
| README.md | | README.md | chore: add link to youtube video | Mar 24, 2025 |
| package-lock.json | | package-lock.json | WIP. reset me! | Mar 7, 2025 |
| package.json | | package.json | chore: bumb version | Mar 13, 2025 |
| tsconfig.json | | tsconfig.json | chore: add basic interfaces | Mar 6, 2025 |
| View all files | | |
Repository files navigation
Tmux MCP Server
Model Context Protocol server that enables Claude Desktop to interact with and view tmux session content. This integration allows AI assistants to read from, control, and observe your terminal sessions.
Features
- List and search tmux sessions
- View and navigate tmux windows and panes
- Capture and expose terminal content from any pane
- Execute commands in tmux panes and retrieve results (use it at your own risk ⚠️)
- Create new tmux sessions and windows
Check out this short video to get excited!
Prerequisites
- Node.js
- tmux installed and running
Usage
Configure Claude Desktop
Add this MCP server to your Claude Desktop configuration:
"mcpServers": {
"tmux": {
"command": "npx",
"args": ["-y", "tmux-mcp"]
}
}
MCP server options
You can optionally specify the command line shell you are using, if unspecified it defaults to bash
"mcpServers": {
"tmux": {
"command": "npx",
"args": ["-y", "tmux-mcp", "--shell-type=fish"]
}
}
The MCP server needs to know the shell only when executing commands, to properly read its exit status.
Available Resources
tmux://sessions- List all tmux sessionstmux://pane/{paneId}- View content of a specific tmux panetmux://command/{commandId}/result- Results from executed commands
Available Tools
list-sessions- List all active tmux sessionsfind-session- Find a tmux session by namelist-windows- List windows in a tmux sessionlist-panes- List panes in a tmux windowcapture-pane- Capture content from a tmux panecreate-session- Create a new tmux sessioncreate-window- Create a new window in a tmux sessionexecute-command- Execute a command in a tmux paneget-command-result- Get the result of an executed command
About
A MCP server for our beloved terminal multiplexer tmux.
Topics
Resources
License
Stars
Watchers
Forks
No releases published
No packages published
Languages
You can’t perform that action at this time.
Invite Gmail Contacts
