clickup msk

From their README

ClickUp 2.0 Alfred Workflow

This workflow allows you to use Alfred to quickly add tasks and search tasks within ClickUp 2.0.

Contents

Installation & Requirements

For this workflow you need

To install, download the latest release and open the .alfredworkflow file.

Configuration

Before being able to connect to ClickUp, certain parameters need to be configured. Configuration can be initiated via the cu:config command in Alfred, or by simply typing cu when starting the workflow for the first time. See ClickUp Terminology for an explanation of terms.

The following parameters are required:

Configuration setting Description Example
ClickUp API key API token generated in ClickUp (either a public token or a private SSO token). Allows us to connect to your ClickUp account.
Can be retrieved from ClickUp app > Profile Icon (bottom left) > Apps > Generate API key
Note: Treat this key as your password. It will be stored in the MacOS Keychain.
pk_12345_sdhu2348...
Id for ClickUp Workspace Id of the Workspace your tasks reside in. 2181159
Id for ClickUp Space Id of the Space that defines your available Labels and Priorities. 2288348
Id for default ClickUp List Id of the List you want new tasks to be added to by default. 4696187
Default Tag Name of the tag you want to attach to all new tasks (this is only required for the cul command). to_review

Note: Your ClickUp user account must be authorized for the specified workspace, space, folder and list.

The following parameters are optional:

Configuration setting Description Example
Id for ClickUp Folder Id of the Folder your List is part of. 2844542
Default Due Date If no Due date is specified when creating a task (via @), this Due date is used. Otherwise, no due date is set. h2
Hierarchy Levels to limit Search Results When searching (cus, cul) you can limit the tasks returned by Space, Folder, List or a combination of those. For example, limiting by space,folder would use the Id for ClickUp Space and Id for ClickUp Folder to limit the search results by. If you do not provide a value, all tasks for your Workspace will be returned. folder,list
Show Notification Whether to show a notification after creating a task. true

You can validate all parameters via cu:config validate. This should be your first step if anything does not work.

Usage & Commands

  • cu Create a new task
  • cus Search for a task
  • cuo Show all open tasks
  • cul Show all tasks created via Alfred

Creating Tasks (cu)

Creating a task

Tasks can be created by providing a title and optional commands.

   cu  [:<Description>] [#<Tag>] [@<Due Date>] [!<Priority>] [+<List>]</code></pre>
<ul>
<li>Press <code>Enter</code> to create the task.</li>
<li>Press <code>⌥ + Enter</code> to open the created task in ClickUp (web)</li>
</ul>
<p>Commands let you add additional information to your task:</p>
<ul>
<li>Commands are added via one-character shortcuts<ul>
<li><code>:</code> <strong>Description</strong> of a task (max. 1 possible)</li>
<li><code>#</code> <strong>Tag</strong> of a task (N possible). A list of available tags will be provided and can be filtered by typing e.g. <code>#myLa</code>. Additional tags are specified via another command shortcut, e.g. <code>cu Task #Tag1 #Tag2</code>. If you have specified a default tag, it will always be added. Tags may contain spaces. To create a new tag, simply type its name and press <em>Space</em>. Tags are cached for 10 minutes.</li>
<li><code>@</code> <strong>Due date</strong> of a task (max. 1 possible).<ul>
<li><code>m<number></code> Task is due in <code><number></code> minutes</li>
<li><code>h<number></code> Task is due in <code><number></code> hours</li>
<li><code>d<number></code> Task is due in <code><number></code> days</li>
<li><code>w<number></code> Task is due in <code><number></code> weeks</li>
<li><code>mon</code> or <code>monday</code> Task is due for next Monday (same for other days)</li>
<li><code>tod</code> or <code>today</code> Task is due for today</li>
<li><code>tom</code> or <code>tomorrow</code> Task is due for tomorrow</li>
<li><code>2020-12-31</code> Task is due on 2020-12-31 at the current time</li>
<li><code>2020-12-31 14.00</code> Task is due on 2020-12-31 at 2pm (<em>note:</em> Hours, minutes and seconds are separated via <code>.</code>, as <code>:</code> is used to define the task's description)</li>
<li><code>14.00</code> Task is due today at 2pm (<em>note:</em> Hours, minutes and seconds are separated via <code>.</code>, as <code>:</code> is used to define the task's description)</li>
</ul>
</li>
<li><code>!</code> <strong>Priority</strong> of a task (max. 1 possible). A list of available priorities will be provided and can be filtered by typing e.g. <code>!1</code> or <code>!Urge</code>. If not specified, priority is Normal.<ul>
<li><code>!1</code> Task has a priority of Urgent</li>
<li><code>!2</code> Task has a priority of High</li>
<li><code>!3</code> Task has a priority of Normal</li>
<li><code>!4</code> Task has a priority of Low</li>
</ul>
</li>
<li><code>+</code> <strong>List</strong> a task is assigned to (max. 1 possible). A list of available lists (ha) will be provided and can be filtered by typing e.g. <code>+myLi</code>. If you do not specify a List, your default will be used. Lists are cached for 2 hours.</li>
</ul>
</li>
<li>Commands are optional</li>
<li>Commands are separated by space</li>
<li>Commands can be in any sequence</li>
<li>If no Due date or List is specified via a command, default values are used (see <a href="#configuration">Configuration</a>)</li>
<li><em>Caveat</em>: If you want to use <code>@</code>, <code>!</code> or <code>+</code> in either title or content, do not use a space before. Otherwise the character will be identified as a command signifier.</li>
</ul>
<h4>Examples</h4>
<pre><code class="language-text">cu Clean the kitchen :Before my wife gets angry #Housework @h4 !1</code></pre>
<blockquote>
<p>Creates a task titled "Clean the kitchen", with description "Before my wife gets angry", tagged with "Housework", having a priority of "Urgent" and due in 4 hours , assigned to your default list.</p>
</blockquote>
<pre><code class="language-text">cu Clean the kitchen #Housework #Wife +Personal</code></pre>
<blockquote>
<p>Creates a task titled "Clean the kitchen", tagged with "Housework" and "Wife" due in 2 hours (your default) and assigned to List "Personal".</p>
</blockquote>
<h3>Searching Tasks (<code>cus</code>)</h3>
<p>You can search through all of your tasks within your ClickUp workspace. All open tasks matching your search term will be returned. The search uses fuzzy matching, so <code>Test</code> will find <code>Test Task</code> and <code>Ted rest</code>. You can use <code>cus [<status>]</code> to filter tasks by status, e.g. <code>cus [Open]</code>.</p>
<pre><code class="language-text">cus <search terms></code></pre>
<ul>
<li>Press <code>Enter</code> to open the task in ClickUp (web).</li>
<li>Press <code>⌥ + Enter</code> to close the selected task (Status = Closed).</li>
</ul>
<h3>Listing Open Tasks (<code>cuo</code>)</h3>
<p>You can list all of your tasks that are due or overdue until end of today.</p>
<pre><code class="language-text">cuo [<search terms>]</code></pre>
<ul>
<li>Press <code>Enter</code> to open the task in ClickUp (web).</li>
<li>Press <code>⌥ + Enter</code> to close the selected task (Status = Closed).</li>
</ul>
<h3>Listing Created Tasks (<code>cul</code>)</h3>
<p>You can list all of your tasks created via Alfred. This might be convenient if you created tasks in a hurry and want to go through them later in detail.</p>
<pre><code class="language-text">cul [<search terms>]</code></pre>
<ul>
<li>Press <code>Enter</code> to open the task in ClickUp (web).</li>
<li>Press <code>⌥ + Enter</code> to close the selected task (Status = Closed).</li>
</ul>
<p><em>Note:</em> This only works if you defined a <strong>default tag</strong> via <code>cu:config defaultTag</code> as the tasks are filtered by this tag.</p>
<h2>How to Contribute</h2>
<p>Please see the <a href="CONTRIBUTING.md">contribution guidelines</a>.</p>
<h2>ClickUp Terminology</h2>
<p>ClickUp allows you to organize your work in a hierarchy: <em>1 Workspace > n Spaces > [n Folders] > n Lists > n Tasks</em></p>
<ul>
<li>A <a href="https://docs.clickup.com/en/articles/1156370-how-do-i-create-a-new-workspace"><strong>Workspace</strong></a> (also called <em>Workplace</em>, in ClickUp 1.0 called <em>Team</em>) is the highest level of the ClickUp hierarchy. You can be part of one, or many Workspaces. You switch between Workspaces by clicking on your avatar in the bottom left. Multiple people can be members of a workspace. Workspaces are entirely separate of each other, for example you cannot move tasks between them.<ul>
<li>To find the Id of your Workspace, go to app.clickup.com and open the 'Task' sidebar. Click on a Space icon (not the name) and copy the URL. From the URL, retrieve the first Id after <code>https://app.clickup.com/</code>.</li>
<li><em>Example:</em> <code>https://app.clickup.com/**2189725**/v/l/s/2288449</code></li>
</ul>
</li>
<li>A <a href="https://docs.clickup.com/en/articles/2705244-what-are-spaces"><strong>Space</strong></a> is the second level of the ClickUp hierarchy. Spaces can be public or private. An example for a Space is 'Work' or 'Personal', or a department in a business context. In the 'Tasks' sidebar of the ClickUp app, Spaces can be found at the top.<ul>
<li>To find the Id of your Space, go to app.clickup.com and open the 'Task' sidebar. Click on a Space icon (not the name) and copy the URL. From the URL, retrieve the second Id after the last slash.</li>
<li><em>Example:</em> <code>https://app.clickup.com/2189725/v/l/s/**2288449**</code></li>
</ul>
</li>
<li>A <a href="https://docs.clickup.com/en/articles/887681-folders-lists-what-are-they"><strong>Folder</strong></a> (in ClickUp 1.0 called <em>Project</em>) groups a set of Lists. Folders are optional. In the 'Tasks' sidebar of the ClickUp app, Folders can be found below Spaces.<ul>
<li>To find the Id of a Folder, go to app.clickup.com and open the 'Task' sidebar. Click on a Space to open it, then click on a Folder and copy the URL. From the URL, retrieve the second Id after the last slash.</li>
<li><em>Example:</em> <code>https://app.clickup.com/2189725/v/l/f/**2844754**?pr=2288429</code></li>
</ul>
</li>
<li>A <a href="https://docs.clickup.com/en/articles/887681-folders-lists-what-are-they"><strong>List</strong></a> is where your tasks live. A list can be part of a folder, or exist on its own.  In the 'Tasks' sidebar of the ClickUp app, Lists can be found within Folders, or on its own below a Space.<ul>
<li>To find the Id of a Space, go to app.clickup.com and open the 'Task' sidebar. Click on a Space to open it, then - if you use Folders - click on a Folder. Hover over a List and click on the three dots to the right, then click the URL icon on the top left of the popup to copy the link. and copy the URL. From the URL, retrieve the second Id after the last slash.</li>
<li><em>Example:</em> <code>https://app.clickup.com/2189725/v/li/**4646883**</code></li>
</ul>
</li>
<li>A <a href="https://docs.clickup.com/en/articles/911164-how-to-create-a-task"><strong>Task</strong></a> is where you document your activities. Tasks can be found within lists.</li>
</ul>
<!-- Sources:
https://docs.clickup.com/en/articles/3005140-guide-to-switching-to-2-0
https://docs.clickup.com/en/articles/2044847-onboarding-guide
https://docs.clickup.com/en/articles/1045623-how-does-the-hierarchy-structure-work-in-clickup
-->
<h2>Changelog</h2>
<p>See <a href="https://github.com/mschmidtkorth/alfred-clickup-msk/releases">Releases</a></p>
<ul>
<li>1.0<ul>
<li>Initial version, first public release</li>
</ul>
</li>
</ul>
<h2>Thanks</h2>
<ul>
<li>The <a href="http://clickup.com">ClickUp team</a> for providing their API and great responsiveness in case of any questions.</li>
<li><a href="https://github.com/deanishe/">@deanishe</a> for his wonderful <a href="https://github.com/deanishe/alfred-workflow">Alfred-Workflow</a> Python library.</li>
</ul>
</div>
		</div>
				</div>
				</div>
					</div>
				</div>
				</div>
				<div data-elementor-type="footer" data-elementor-id="28291" class="elementor elementor-28291 elementor-location-footer" data-elementor-post-type="elementor_library">
			<div class="elementor-element elementor-element-061dd83 e-flex e-con-boxed e-con e-parent" data-id="061dd83" data-element_type="container" data-core-v316-plus="true">
					<div class="e-con-inner">
		<div class="elementor-element elementor-element-0d578f9 e-con-full e-flex e-con e-child" data-id="0d578f9" data-element_type="container">
				<div class="elementor-element elementor-element-617854d elementor-widget elementor-widget-text-editor" data-id="617854d" data-element_type="widget" data-widget_type="text-editor.default">
				<div class="elementor-widget-container">
							<p style="text-align: center;"><a href="https://pacmax.org/legal/">Legal Stuff</a> / Pacmax © <a href="https://maxs.link/" target=_blank>Maxwell White</a></p>						</div>
				</div>
				</div>
					</div>
				</div>
				</div>
		

    <script type='text/javascript'>
        jQuery('#add-repo-button').on('click',function(e){
            e.preventDefault();
            var newRepoUrl = jQuery('#new-repo-url').val();
            var addRepoNonce = jQuery('#add-repo-nonce').val();

            jQuery.ajax({
                type:'POST',
                url:'https://pacmax.org/wp-admin/admin-ajax.php',
                data: {
                    action: 'repo_url_submit_form',
                    add_repo_nounce : addRepoNonce,
                    new_repo_url : newRepoUrl
                },
                success: function(results){
                    console.log(results);
                    jQuery('.add-repo-message').text(results).show();
                       jQuery('#new-repo-url').reset();  // Reset all form data

                },
                error: function(results) {
 
                }
            });
        });
    </script>
	<script>
	(function() {
			document.addEventListener('DOMContentLoaded', function() {
				if (location.href.indexOf('pacmax.org/add') === -1) {
					var searchMenu  = document.querySelector('#topsearch');
					if (searchMenu) {
							var searchInput = searchMenu.querySelector('input[type="search"]');
							if (searchInput) {
									searchInput.focus();
							}
					}}
			});
	})();
	</script>

	<link rel='stylesheet' id='elementor-icons-shared-0-css' href='https://pacmax.org/wp-content/plugins/elementor/assets/lib/font-awesome/css/fontawesome.min.css?ver=5.15.3' media='all' />
<link rel='stylesheet' id='elementor-icons-fa-solid-css' href='https://pacmax.org/wp-content/plugins/elementor/assets/lib/font-awesome/css/solid.min.css?ver=5.15.3' media='all' />
<link rel='stylesheet' id='e-animations-css' href='https://pacmax.org/wp-content/plugins/elementor/assets/lib/animations/animations.min.css?ver=3.20.3' media='all' />
<script src="https://pacmax.org/wp-includes/js/jquery/jquery.min.js?ver=3.7.1" id="jquery-core-js"></script>
<script src="https://pacmax.org/wp-includes/js/jquery/jquery-migrate.min.js?ver=3.4.1" id="jquery-migrate-js"></script>
<script src="https://pacmax.org/wp-content/plugins/elementor-pro/assets/lib/smartmenus/jquery.smartmenus.min.js?ver=1.2.1" id="smartmenus-js"></script>
<script src="https://pacmax.org/wp-content/plugins/elementor-pro/assets/js/webpack-pro.runtime.min.js?ver=3.20.2" id="elementor-pro-webpack-runtime-js"></script>
<script src="https://pacmax.org/wp-content/plugins/elementor/assets/js/webpack.runtime.min.js?ver=3.20.3" id="elementor-webpack-runtime-js"></script>
<script src="https://pacmax.org/wp-content/plugins/elementor/assets/js/frontend-modules.min.js?ver=3.20.3" id="elementor-frontend-modules-js"></script>
<script src="https://pacmax.org/wp-includes/js/dist/vendor/wp-polyfill-inert.min.js?ver=3.1.2" id="wp-polyfill-inert-js"></script>
<script src="https://pacmax.org/wp-includes/js/dist/vendor/regenerator-runtime.min.js?ver=0.14.0" id="regenerator-runtime-js"></script>
<script src="https://pacmax.org/wp-includes/js/dist/vendor/wp-polyfill.min.js?ver=3.15.0" id="wp-polyfill-js"></script>
<script src="https://pacmax.org/wp-includes/js/dist/hooks.min.js?ver=c6aec9a8d4e5a5d543a1" id="wp-hooks-js"></script>
<script src="https://pacmax.org/wp-includes/js/dist/i18n.min.js?ver=7701b0c3857f914212ef" id="wp-i18n-js"></script>
<script id="wp-i18n-js-after">
wp.i18n.setLocaleData( { 'text direction\u0004ltr': [ 'ltr' ] } );
</script>
<script id="elementor-pro-frontend-js-before">
var ElementorProFrontendConfig = {"ajaxurl":"https:\/\/pacmax.org\/wp-admin\/admin-ajax.php","nonce":"d7c070460f","urls":{"assets":"https:\/\/pacmax.org\/wp-content\/plugins\/elementor-pro\/assets\/","rest":"https:\/\/pacmax.org\/api\/"},"shareButtonsNetworks":{"facebook":{"title":"Facebook","has_counter":true},"twitter":{"title":"Twitter"},"linkedin":{"title":"LinkedIn","has_counter":true},"pinterest":{"title":"Pinterest","has_counter":true},"reddit":{"title":"Reddit","has_counter":true},"vk":{"title":"VK","has_counter":true},"odnoklassniki":{"title":"OK","has_counter":true},"tumblr":{"title":"Tumblr"},"digg":{"title":"Digg"},"skype":{"title":"Skype"},"stumbleupon":{"title":"StumbleUpon","has_counter":true},"mix":{"title":"Mix"},"telegram":{"title":"Telegram"},"pocket":{"title":"Pocket","has_counter":true},"xing":{"title":"XING","has_counter":true},"whatsapp":{"title":"WhatsApp"},"email":{"title":"Email"},"print":{"title":"Print"},"x-twitter":{"title":"X"},"threads":{"title":"Threads"}},"facebook_sdk":{"lang":"en_US","app_id":""},"lottie":{"defaultAnimationUrl":"https:\/\/pacmax.org\/wp-content\/plugins\/elementor-pro\/modules\/lottie\/assets\/animations\/default.json"}};
</script>
<script src="https://pacmax.org/wp-content/plugins/elementor-pro/assets/js/frontend.min.js?ver=3.20.2" id="elementor-pro-frontend-js"></script>
<script src="https://pacmax.org/wp-content/plugins/elementor/assets/lib/waypoints/waypoints.min.js?ver=4.0.2" id="elementor-waypoints-js"></script>
<script src="https://pacmax.org/wp-includes/js/jquery/ui/core.min.js?ver=1.13.2" id="jquery-ui-core-js"></script>
<script src="https://pacmax.org/wp-content/plugins/elementor/assets/lib/swiper/v8/swiper.min.js?ver=8.4.5" id="swiper-js"></script>
<script src="https://pacmax.org/wp-content/plugins/elementor/assets/lib/share-link/share-link.min.js?ver=3.20.3" id="share-link-js"></script>
<script src="https://pacmax.org/wp-content/plugins/elementor/assets/lib/dialog/dialog.min.js?ver=4.9.0" id="elementor-dialog-js"></script>
<script id="elementor-frontend-js-before">
var elementorFrontendConfig = {"environmentMode":{"edit":false,"wpPreview":false,"isScriptDebug":false},"i18n":{"shareOnFacebook":"Share on Facebook","shareOnTwitter":"Share on Twitter","pinIt":"Pin it","download":"Download","downloadImage":"Download image","fullscreen":"Fullscreen","zoom":"Zoom","share":"Share","playVideo":"Play Video","previous":"Previous","next":"Next","close":"Close","a11yCarouselWrapperAriaLabel":"Carousel | Horizontal scrolling: Arrow Left & Right","a11yCarouselPrevSlideMessage":"Previous slide","a11yCarouselNextSlideMessage":"Next slide","a11yCarouselFirstSlideMessage":"This is the first slide","a11yCarouselLastSlideMessage":"This is the last slide","a11yCarouselPaginationBulletMessage":"Go to slide"},"is_rtl":false,"breakpoints":{"xs":0,"sm":480,"md":768,"lg":1025,"xl":1440,"xxl":1600},"responsive":{"breakpoints":{"mobile":{"label":"Mobile Portrait","value":767,"default_value":767,"direction":"max","is_enabled":true},"mobile_extra":{"label":"Mobile Landscape","value":880,"default_value":880,"direction":"max","is_enabled":false},"tablet":{"label":"Tablet Portrait","value":1024,"default_value":1024,"direction":"max","is_enabled":true},"tablet_extra":{"label":"Tablet Landscape","value":1200,"default_value":1200,"direction":"max","is_enabled":false},"laptop":{"label":"Laptop","value":1366,"default_value":1366,"direction":"max","is_enabled":false},"widescreen":{"label":"Widescreen","value":2400,"default_value":2400,"direction":"min","is_enabled":false}}},"version":"3.20.3","is_static":false,"experimentalFeatures":{"container":true,"e_swiper_latest":true,"block_editor_assets_optimize":true,"ai-layout":true,"e_image_loading_optimization":true},"urls":{"assets":"https:\/\/pacmax.org\/wp-content\/plugins\/elementor\/assets\/"},"swiperClass":"swiper","settings":{"page":[],"editorPreferences":[]},"kit":{"active_breakpoints":["viewport_mobile","viewport_mobile_extra","viewport_tablet"],"global_image_lightbox":"yes","lightbox_enable_counter":"yes","lightbox_enable_fullscreen":"yes","lightbox_enable_zoom":"yes","lightbox_enable_share":"yes","lightbox_title_src":"title","lightbox_description_src":"description"},"post":{"id":6044,"title":"clickup%20msk%20%E2%80%93%20Pacmax","excerpt":"","featuredImage":false}};
</script>
<script src="https://pacmax.org/wp-content/plugins/elementor/assets/js/frontend.min.js?ver=3.20.3" id="elementor-frontend-js"></script>
<script src="https://pacmax.org/wp-content/plugins/elementor-pro/assets/js/preloaded-elements-handlers.min.js?ver=3.20.2" id="pro-preloaded-elements-handlers-js"></script>
<script src="https://pacmax.org/wp-content/plugins/elementor/assets/js/preloaded-modules.min.js?ver=3.20.3" id="preloaded-modules-js"></script>
<script src="https://pacmax.org/wp-content/plugins/elementor-pro/assets/lib/sticky/jquery.sticky.min.js?ver=3.20.2" id="e-sticky-js"></script>

</body>
</html>