servers / agent-toolkit-mcp-server

agent-toolkit-mcp-server

communityunknownpythondestructive capablehealthy

MCP server providing persistent notes, todos, timers, and a cross-project registry — capabilities that augment Claude Code's built-in harness.


01Tools · 62

How to read this: tool names here are observed from a live tools/list handshake. The Risk label is a heuristic inferred from the tool name (write/destructive verbs), not from executing the tool — a conservative guess, not a verified capability. We never escalate risk from a description. Found one that's wrong? Tell us — we fix on report.

ToolRiskSide effectsApproval
timer_cancel
Cancel a pending timer.
destructivetruetrue
todo_complete
Mark a todo as done.
unknownunknownunknown
todo_set_blockers
Replace the entire blocker list for a todo at once. blockers: comma-separated todo ids; pass '' to clear all blockers.
writetrueunknown
timer_resume
Resume a paused timer.
unknownunknownunknown
todo_delete
Delete a todo.
destructivetruetrue
todo_tags_list
List distinct tags used by todos in scope.
readfalseunknown
todo_transfer
Bulk-move one or more todos to a different project. ids: comma-separated todo ids. target_project: registered project name, or '' for the global scope.
writetrueunknown
todo_list
List todos. project='' means _global scope (use project_register name otherwise). status: open|in_progress|done|cancelled|active|all. 'active' = open + in_progress. tags: comma-separated; a todo must have ALL listed tags to match.
readfalseunknown
project_update
Update path, description, tags, and/or members on a registered project. members: pass a JSON array to replace the list, '[]' to clear. Omit to leave unchanged.
writetrueunknown
todo_add_blocker
Add another todo id as a blocker on this todo.
writetrueunknown
template_delete
Delete a prompt template by id or name.
destructivetruetrue
project_doc_write
Create or replace a project doc. Leading H1 in content is used as the title.
writetrueunknown
note_clear
Clear a note's body while keeping its frontmatter.
unknownunknownunknown
project_doc_list
List markdown docs attached to a project (slug, title, size, updated).
readfalseunknown
project_remove
Remove a project from the registry (does not delete files).
destructivetruetrue
project_resolve
Return the absolute path for a project, optionally joined with a relative subpath.
unknownunknownunknown
project_get
Look up a single registered project by name (includes members + doc names).
readfalseunknown
template_get
Get a prompt template by id or name.
readfalseunknown
note_find
Literal substring search within a single note. Returns matching line refs.
readfalseunknown
todo_remove_blocker
Remove a blocker from a todo.
destructivetruetrue
note_append
Append content to the end of a note's body.
unknownunknownunknown
timer_pause
Pause a pending timer.
unknownunknownunknown
template_render
Render a prompt template by substituting {variable} placeholders. variables: comma-separated key=value pairs, e.g. "lang=Python,topic=async". Returns the rendered text plus a list of any unresolved placeholders.
readfalseunknown
todo_add_tag
Add a single tag to a todo.
writetrueunknown
note_archive
Mark a note as archived; archived notes are hidden from default list.
destructivetruetrue
note_tail
Return the last N lines of a note's body.
unknownunknownunknown
todo_create
Create a new todo. Returns the new id.
writetrueunknown
todo_lock
Lock a todo to prevent any modifications or deletion.
unknownunknownunknown
todo_comment_add
Add a comment to a todo. Returns the new comment.
writetrueunknown
project_list
List registered projects, optionally filtered by comma-separated tags.
readfalseunknown
timer_ack
Clear all fired events for a specific timer id.
unknownunknownunknown
timer_fired
List timers that have fired. If ack=true, also clear them.
readfalseunknown
idle_watch_list
List all idle watches (both pending and already fired).
readfalseunknown
todo_unlock
Unlock a previously locked todo, allowing modifications again.
unknownunknownunknown
todo_comment_list
List all comments for a todo, ordered by creation time.
writetrueunknown
todo_comment_delete
Delete a comment.
destructivetruetrue
note_list
List notes in scope with tags/revision; tags is a comma-separated filter.
readfalseunknown
note_remove_tags
Remove comma-separated tags from a note.
destructivetruetrue
template_list
List all prompt templates. Optionally filter by tags (comma-separated, must match ALL).
readfalseunknown
note_write
Create or replace a note. Leading H1 in content is used as the title.
writetrueunknown
note_read
Read a note. mode: full | headings | section (requires `section`).
readfalseunknown
timer_list
List pending timers.
readfalseunknown
note_append_section
Append content under an existing heading in a note.
unknownunknownunknown
note_tags_list
List distinct tags used across notes in scope.
readfalseunknown
project_doc_delete
Delete a project doc.
destructivetruetrue
note_rename
Rename a note within the same project scope.
writetrueunknown
note_delete
Delete a note file.
destructivetruetrue
todo_get
Get a todo's full details.
readfalseunknown
template_create
Create a reusable prompt template. Use {variable_name} placeholders in the template text; they are extracted automatically. name must be unique.
writetrueunknown
todo_comment_edit
Edit the body of an existing comment.
writetrueunknown
note_add_tags
Add comma-separated tags to a note.
writetrueunknown
todo_remove_tag
Remove a single tag from a todo.
destructivetruetrue
project_doc_read
Read a project doc's full markdown content.
readfalseunknown
project_register
Register a repo or folder by name. Path must be absolute and exist. members: optional JSON array like '[{"path": "/abs", "label": "frontend", "description": "..."}]'.
unknownunknownunknown
todo_update
Partial update — change text, status, and/or move to a different project.
writetrueunknown
fire_when_idle_all
Register a watch that fires once ALL listed todos reach done or cancelled status. todo_ids: comma-separated todo ids to watch. Fires into the same fired_timers table as time-based timers; use timer_fired to poll.
readfalseunknown
template_update
Partial update for a prompt template. Pass only the fields you want to change.
writetrueunknown
note_edit
Replace a section (by heading) or a line range (1-indexed, inclusive) in a note.
writetrueunknown
note_search
FTS5 search across notes and (optionally) project docs. - query: FTS5 MATCH expression (e.g. 'foo bar', '"exact phrase"', 'foo OR bar'). - project: empty = search across ALL scopes (including _global and all projects); named project = restrict to that scope only. - kinds: comma-separated subset of {note, project_doc}. Returns: list of {kind, project, name, title, snippet}.
readfalseunknown
timer_set
Schedule a timer. Provide either fire_in_seconds or an ISO8601 fire_at.
writetrueunknown
fire_when_idle_any
Register a watch that fires once ANY of the listed todos reaches done or cancelled status. todo_ids: comma-separated todo ids to watch. Fires into the same fired_timers table as time-based timers; use timer_fired to poll.
readfalseunknown
idle_watch_cancel
Cancel (delete) an idle watch that hasn't fired yet.
destructivetruetrue

02Install & source
uvx agent-toolkit-mcp-server
uvx
pip install agent-toolkit-mcp-server
pip

03Access granted
Read & write files · destructive

The access this server can exercise, inferred from its verified tools — not a declared OAuth scope.


05Provenance & freshness
sourcesPyPI [p4]
last_checked2026-08-16 19:31Z
next_check2026-08-16 22:31Z
cadenceevery 3h
verifiedhandshake:failed metadata:passed handshake:failed metadata:passed handshake:failed metadata:passed handshake:failed metadata:passed metadata:passed handshake:failed
index_statusindex9 unique facts >= 5

06Badge

Add the “as seen on MCPExplorer” badge to your README. agent-toolkit-mcp-server MCP — as seen on mcpexplorer.com

[![agent-toolkit-mcp-server MCP — as seen on mcpexplorer.com](https://mcpexplorer.com/badge/agent-toolkit-mcp-server.svg)](https://mcpexplorer.com/servers/agent-toolkit-mcp-server)

Next step

This is one server. A loadout combines the right servers, governance, and proven plays for a whole job — assembled deliberately, not tool-dumped.

Explore loadouts →