How do I use Jotty MCP Server?

This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.

Jotty MCP Server

by mshowaib

Overview Schema Source Related Servers Discussions Admin

Python

Hybrid

Jotty MCP Server

Model Context Protocol (MCP) server for Jotty — provides programmatic access to notes, checklists, tasks (Kanban boards), and categories.

Features

Notes: Create, read, update, delete markdown notes
Checklists: Full checklist management with nested items, priorities, timestamps
Tasks/Kanban: Kanban-style task boards with custom columns and item status management
Search: Full-text search across notes and checklists
Multi-user: API key passed per tool call (not env var) — different users can share the same MCP instance

Related MCP server: businessmap-mcp

Setup

Local

pip install -r requirements.txt

Stdio mode (default — for local editors/tools like Claude Desktop, Cursor):

JOTTY_BASE_URL=https://jotty.showaib.com python -m src.main

HTTP mode (for remote MCP clients):

JOTTY_BASE_URL=https://jotty.showaib.com PORT=3008 python -m src.main --transport http

Docker

# Stdio mode (default — local CLI)
docker compose up --build -d jotty-mcp

# HTTP mode (remote clients)
MCP_TRANSPORT=http docker compose up --build -d jotty-mcp

Server is available at http://localhost:3008/mcp when using HTTP transport. Connect with any MCP HTTP client.

Configuration

Variable	Default	Description
`JOTTY_BASE_URL`	`http://localhost:3000`	URL of your Jotty instance
`MCP_TRANSPORT`	`stdio`	Transport mode (`stdio` or `http`)
`PORT`	`3008`	HTTP server port (docker-compose uses host networking)

Note: The API key is not an environment variable — it is passed per-tool call to support multiple users.

MCP Tools

Notes

Tool	Description
`list_notes(api_key, category?, q?)`	List notes with optional category filter and search
`get_note(api_key, note_id)`	Get a single note by ID
`create_note(api_key, title, content?, category?)`	Create a new note (content supports Markdown)
`update_note(api_key, note_id, title?, content?, category?)`	Update a note (provide only fields to change)
`delete_note(api_key, note_id)`	Delete a note by ID

Checklists

Tool	Description
`list_checklists(api_key, category?, checklist_type?, q?)`	List checklists with optional filters (checklist_type: simple/task)
`get_checklist(api_key, list_id)`	Get a single checklist by ID
`create_checklist(api_key, title, category?, checklist_type?)`	Create a new checklist (use checklist_type='task' for Kanban)
`delete_checklist(api_key, list_id)`	Delete a checklist by ID

Checklist Items

Tool	Description
`add_checklist_item(api_key, list_id, text, parent_index?, status?)`	Add item to checklist (use parent_index for nesting)
`update_checklist_item(api_key, list_id, item_index, text?, description?, priority?, score?, start_date?, target_date?, estimated_time?)`	Update item fields
`delete_checklist_item(api_key, list_id, item_index)`	Delete an item by index path (e.g., "0", "0.1")
`check_checklist_item(api_key, list_id, item_index)`	Mark item as completed
`uncheck_checklist_item(api_key, list_id, item_index)`	Mark item as incomplete
`reorder_checklist_items(api_key, list_id, active_item_id, over_item_id, position?, is_drop_into?)`	Reorder items (before/after/nest)

Tasks (Kanban)

Tool	Description
`list_tasks(api_key, category?, status?, q?)`	List Kanban task boards
`get_task(api_key, task_id)`	Get a single Kanban board by ID
`create_task(api_key, title, category?, statuses?)`	Create a Kanban board (statuses: optional JSON string of columns)
`update_task(api_key, task_id, title?, category?)`	Update board metadata (title or category only)
`delete_task(api_key, task_id)`	Delete a Kanban board by ID

Kanban Columns (Statuses)

Tool	Description
`get_task_statuses(api_key, task_id)`	Get all Kanban columns for a board
`add_task_status(api_key, task_id, status_id, label, color?, order?)`	Add a new Kanban column
`update_task_status(api_key, task_id, status_id, label?, color?, order?)`	Update a column's properties
`delete_task_status(api_key, task_id, status_id)`	Delete a column (items move to first available)

Task Items

Tool	Description
`create_task_item(api_key, task_id, text, status?, parent_index?, description?)`	Add item to a Kanban board (supports nested sub-items and descriptions)
`get_task_item(api_key, task_id, item_index)`	Get an item by index
`update_task_item(api_key, task_id, item_index, text?, description?, priority?, score?, start_date?, target_date?, estimated_time?)`	Update a Kanban card's metadata fields (PATCH semantics)
`update_task_item_status(api_key, task_id, item_index, status)`	Move item to different column
`delete_task_item(api_key, task_id, item_index)`	Delete an item by index

General

Tool	Description
`search_jotty(api_key, q, search_type?)`	Full-text search across notes and checklists (search_type: note/checklist)
`get_categories(api_key)`	Get all categories organized by type
`get_summary(api_key, username?)`	Get user statistics (note/checklist counts, completion rates)

Example Usage

# List all notes for a user
mcp.list_notes(
    api_key="user1-api-key-here",
    category="Work"
)

# Create a note
mcp.create_note(
    api_key="user1-api-key-here",
    title="Meeting Notes",
    content="# Weekly Sync\n- Discussed roadmap\n- Action items...",
    category="Work"
)

# Add item to checklist
mcp.add_checklist_item(
    api_key="user2-api-key-here",
    list_id="<checklist-uuid>",
    text="Review PRs",
    status="in_progress"
)

# Move task between Kanban columns
mcp.update_task_item_status(
    api_key="user1-api-key-here",
    task_id="<task-uuid>",
    item_index="0",
    status="in_progress"
)

# Update a Kanban card's metadata (priority, dates, etc.)
mcp.update_task_item(
    api_key="user1-api-key-here",
    task_id="<task-uuid>",
    item_index="0",
    priority="high",
    target_date="2026-07-01"
)

# Create a card with description
mcp.create_task_item(
    api_key="user1-api-key-here",
    task_id="<task-uuid>",
    text="Implement authentication",
    status="todo",
    description="Add JWT-based auth flow"
)

License

MIT

This server cannot be deployed

Pay for results, not tokens.Fund a bounty. Let AI agents compete and collaborate to solve your problems.agentbounties.appAd

Resources

Related MCP Connectors

Clean Notes A
app.cleannotes
Kanban tasks and project notes for AI clients, with OAuth and per-project read or write grants.
Project Management Note Taking Security
111
https://cleannotes.app/mcp
ainote B
io.github.seunghan91
Agent-native notes, tasks, dev-docs, vaults, sync & handoffs. MCP + OpenAPI dual surface.
Note Taking Developer Tools Knowledge & Memory
3
https://api.ainote.dev/api/mcp
Flow Productivity
io.github.geraldho81
Notes, kanban tasks, and a capture inbox: read and create Flow data with a personal token.
Note Taking Project Management Workplace & Productivity
2
https://neighborly-stoat-529.eu-west-1.convex.site/mcp
AI Tasker
dev.theboomer
Task and sprint coordination for humans and AI agents, with scoped API keys and full audit trail.
Project Management Security Autonomous Agents
1
https://mcp.ai-tasker.theboomer.dev/mcp

Related MCP Servers

TriliumNext Notes' MCP Server
Note Taking RAG Systems Knowledge & Memory
tan-yong-sheng
F
license
A
quality
C
maintenance
A model context protocol server that allows interaction with TriliumNext Notes, providing tools to create, search, retrieve, update, and delete notes through natural language commands.
Updated 7 months ago (2026-03-24 07:09 UTC)
9
354 npm
69
-
businessmap-mcp
Project Management Developer Tools
edicarloslds
A
license
Not graded
quality
A
maintenance
Model Context Protocol server for BusinessMap (Kanbanize) integration. Provides comprehensive access to BusinessMap's project management features including workspaces, boards, cards, subtasks, parent-child relationships, outcomes, custom fields, and more.
Updated 7 days ago (2026-10-28 22:24 UTC)
891 npm
13
MIT
ClickUp MCP Server
Project Management Workplace & Productivity App Automation
polaralias
F
license
Not graded
quality
Not graded
maintenance
Enables integration with ClickUp project management platform through a Model Context Protocol server, providing tooling for task management, workspace operations, and team collaboration with flexible authentication and deployment options.
Updated a year ago (2025-11-08 20:50 UTC)
426 npm
-
ClickUp MCP Server
Project Management Workplace & Productivity App Automation
rubenaguir
A
license
B
quality
D
maintenance
Enables integration with ClickUp's task management platform, allowing users to retrieve, create, update, and manage tasks and lists through the Model Context Protocol.
Updated a year ago (2025-11-27 04:25 UTC)
4
426 npm
2
MIT

Jotty MCP Server

Features

Setup

Local

Docker

Configuration

MCP Tools

Notes

Checklists

Checklist Items

Tasks (Kanban)

Kanban Columns (Statuses)

Task Items

General

Example Usage

License

Resources

Related MCP Connectors

Related MCP Servers

TriliumNext Notes' MCP Server

businessmap-mcp

ClickUp MCP Server

ClickUp MCP Server