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
Copy file name to clipboardExpand all lines: README.md
+18-28Lines changed: 18 additions & 28 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -7,13 +7,13 @@ A Model Context Protocol (MCP) server for integrating [Omarchy](https://omarchy.
7
7
Omarchy MCP enables AI assistants to manage themes in Omarchy - a Linux desktop environment that supports extensive theme customization including color schemes, backgrounds, and UI elements.
8
8
9
9
With this MCP server, AI assistants can:
10
-
- List available themes (built-in and custom/extra themes)
10
+
- List themes with flexible filtering (installed, available, built-in, removable)
11
+
- Query the currently active theme
11
12
- Switch between installed themes
12
13
- Preview theme images before applying them
13
14
- Install new themes from GitHub repositories
14
-
-Uninstall themes
15
+
-Remove installed extra themes
15
16
- Rotate background images
16
-
- Query the currently active theme
17
17
18
18
## Installation
19
19
@@ -95,21 +95,22 @@ For development, you can run this server using `uv`:
95
95
96
96
### omarchy_theme_list
97
97
98
-
Lists installed Omarchy themes.
98
+
Lists Omarchy themes with flexible filtering options.
99
99
100
100
**Parameters:**
101
101
-`filter` (optional): Filter themes by type
102
-
-`"ALL"` (default) - All installed themes
102
+
-`"INSTALLED"` (default) - All installed themes
103
+
-`"ALL"` - All available themes (installed and not installed)
104
+
-`"CURRENT"` - Only the currently active theme
103
105
-`"BUILT_IN"` - Only built-in themes
104
-
-`"EXTRA"` - Only custom/extra themes
105
-
106
-
**Returns:** List of theme names, one per line
107
-
108
-
### omarchy_theme_current
109
-
110
-
Gets the currently active theme.
106
+
-`"CAN_REMOVE"` - Only installed extra themes that can be removed
107
+
-`"CAN_INSTALL"` - Only themes available for installation
108
+
-`scheme` (optional): Filter by color scheme
109
+
-`"ANY"` (default) - All color schemes
110
+
-`"LIGHT"` - Light themed only
111
+
-`"DARK"` - Dark themed only
111
112
112
-
**Returns:**Current theme name
113
+
**Returns:**List of theme names with status indicators (current, built-in, installed)
113
114
114
115
### omarchy_theme_set
115
116
@@ -126,17 +127,6 @@ Rotates to the next background image in the current theme.
126
127
127
128
**Returns:** The new background image
128
129
129
-
### omarchy_extra_themes_to_install
130
-
131
-
Lists available extra themes that can be installed from GitHub.
132
-
133
-
**Parameters:**
134
-
-`scheme` (optional): Filter by color scheme
135
-
-`"DARK"` (default) - Dark themed extras
136
-
-`"LIGHT"` - Light themed extras
137
-
138
-
**Returns:** List of installable theme names
139
-
140
130
### omarchy_preview_theme
141
131
142
132
Downloads and returns a preview image for a theme without applying it.
@@ -146,18 +136,18 @@ Downloads and returns a preview image for a theme without applying it.
146
136
147
137
**Returns:** Theme preview image
148
138
149
-
### omarchy_install_extra_theme
139
+
### omarchy_install_theme
150
140
151
-
Installs a new extra/community theme from its GitHub repository.
141
+
Installs a new extra/community theme from its GitHub repository. Installing a theme automatically sets it as the current theme.
152
142
153
143
**Parameters:**
154
144
-`name` (required): Theme name to install
155
145
156
146
**Returns:** Theme preview image after installation
157
147
158
-
### omarchy_uninstall_extra_theme
148
+
### omarchy_remove_theme
159
149
160
-
Uninstalls a previously installed extra/community theme.
150
+
Uninstalls a previously installed extra/community theme. Built-in themes cannot be removed.
0 commit comments