note_list
List notes for project entities like organizations, projects, tickets, or tasks to review summaries and access details. Returns note IDs, creation dates, and previews for efficient project tracking.
Instructions
PROJECT MANAGEMENT (TPM): List notes for an entity. Returns id, created_at, preview (first 100 chars). Use note_get for full content.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| entity_type | Yes | Type of entity | |
| entity_id | Yes | ID of the entity | |
| limit | No | Max notes to return (default: 20, max: 50) |
Implementation Reference
- src/tpm_mcp/server.py:717-731 (handler)The handler logic for the 'note_list' tool inside _handle_tool function. Retrieves notes from the database for a given entity, applies pagination limit, and returns a JSON list containing note ID, creation time, and a preview of the content (first 100 chars).
if name == "note_list": notes = db.get_notes(args["entity_type"], args["entity_id"]) limit = min(args.get("limit", 20), 50) total = len(notes) notes = notes[:limit] # Return IDs + preview only - use note_get for full content result = [ { "id": n.id, "created_at": n.created_at.isoformat(), "preview": n.content[:100] + "..." if len(n.content) > 100 else n.content, } for n in notes ] return _json({"notes": result, "limit": limit, "total": total}) - src/tpm_mcp/server.py:399-419 (registration)Registration of the 'note_list' tool in the list_tools() function, including the tool name, description, and input schema definition.
Tool( name="note_list", description="PROJECT MANAGEMENT (TPM): List notes for an entity. Returns id, created_at, preview (first 100 chars). Use note_get for full content.", inputSchema={ "type": "object", "properties": { "entity_type": { "type": "string", "enum": ["org", "project", "ticket", "task"], "description": "Type of entity", }, "entity_id": {"type": "string", "description": "ID of the entity"}, "limit": { "type": "integer", "description": "Max notes to return (default: 20, max: 50)", "default": 20, }, }, "required": ["entity_type", "entity_id"], }, ), - src/tpm_mcp/server.py:402-418 (schema)Input schema definition for the note_list tool, specifying properties like entity_type (enum), entity_id, and optional limit.
inputSchema={ "type": "object", "properties": { "entity_type": { "type": "string", "enum": ["org", "project", "ticket", "task"], "description": "Type of entity", }, "entity_id": {"type": "string", "description": "ID of the entity"}, "limit": { "type": "integer", "description": "Max notes to return (default: 20, max: 50)", "default": 20, }, }, "required": ["entity_type", "entity_id"], },