note_list
Retrieve notes for project entities like organizations, projects, tickets, or tasks. Returns note IDs, creation dates, and content previews to track discussions and updates.
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 within the _handle_tool function. It fetches notes from the database for the specified entity, applies pagination limit, generates previews, and returns a JSON response with note summaries.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 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 parameters for entity_type, 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"], },