# Memo Meister MCP

> Memo Meister connects your AI agent directly to structured field documentation. It lets you create, read, and organize project memos—think of it as a central hub for site reports, safety audits, and file logs. You can manage entire projects, track task status updates, and query all attached PDFs or photos using natural conversation.

## Overview
- **Category:** document-management
- **Price:** Free
- **Tags:** field-documentation, smart-notes, construction-reports, file-organization, project-files, knowledge-management

## Description

Memo Meister connects your AI agent right into structured field documentation. You use it to build and manage project notes—think of it like the ultimate central hub for site reports, safety audits, and file logs. This server handles all the messy details so you don't gotta juggle a dozen different apps.

**Managing Projects:** When you need the big picture, you can pull every single project container that exists across your whole account by using `list_projects`. If you know which site or job you wanna check on, you use `get_project` to grab all the structural details for that specific container. You'll see the complete scope of everything tied to one project.

**Tracking Memos:** Within any given project, you can list every memo using `list_memos`. If you need details on a single note—say, the report from last Tuesday—you use `get_memo` with its ID. You'll get all the content and specifics of that whole document. Need to make it better? Just run `update_memo`; you can change or correct any existing info in the memo record.

You wanna add a new note? Use `create_memo` to build a brand-new memo, making sure you place it inside the right project container from jump. And if that memo is totally useless and needs to vanish forever, run `delete_memo`. It takes the whole thing out of the system.

**Digging Into Details:** When you're looking at a specific memo, there are two key things: comments and files. You can check who talked about it by using `list_memo_comments` to pull all existing commentary on that note. If someone drops a new thought, you use `add_memo_comment` to pin that comment right onto the record. For the physical evidence—the site photos or PDF reports—you run `list_memo_files`. That pulls out a full manifest of every file attached to the memo.

**User Context:** You can always check who's connected and what your basic profile info is by invoking `get_me`.

This system keeps everything organized: it groups related memos into projects, tracks all associated files (whether they're PDFs or pics), and manages entire comment threads right where the action is. Your agent uses these tools to process structured knowledge, letting you talk naturally about your site work and get actionable data back.

## Tools

### add_memo_comment
Adds a comment to an existing memo record in the system.

### create_memo
Makes a brand new note (memo) and places it inside a specific project.

### delete_memo
Removes an entire memo from the system.

### get_me
Pulls basic information about the current user connected to the server.

### get_memo
Retrieves all content and details for one specific memo using its ID.

### get_project
Gets the overall structural information for a whole project container.

### list_memo_comments
Lists all comments that have been made to a specific memo.

### list_memo_files
Retrieves a list of all files (images, PDFs) attached to a given memo.

### list_memos
Lists all the memos in a specific project container.

### list_projects
Shows every single project that exists across the entire Memo Meister account.

### update_memo
Changes or corrects existing information in a memo.

## Prompt Examples

**Prompt:** 
```
Show recent memos in the 'Downtown Office Build' project.
```

**Response:** 
```
Project 'Downtown Office Build': 3 recent memos. 1) 'HVAC Installation Update' (By Mike, Today 10:00 AM). 2) 'Safety Inspection Report' (By Sarah, Yesterday. 1 PDF attached). 3) 'Material Delivery Photos' (By John, Monday. 4 Images attached).
```

**Prompt:** 
```
Create a new memo for the daily site report.
```

**Response:** 
```
Memo created! ✅ Title: 'Daily Site Report - Apr 26'. Project: 'Downtown Office Build'. Content: 'Foundation pouring completed. Weather clear. No safety incidents.'. Tags: [daily-report, foundation, safety]. ID: memo_8901.
```

**Prompt:** 
```
List all open tasks assigned to me across projects.
```

**Response:** 
```
Open tasks (Assigned to you): 4. 1) 'Review Electrical Plan' (Project A, Due: Tomorrow). 2) 'Approve Material Invoice' (Project B, Due: Friday). 3) 'Schedule Crane Delivery' (Project A, Overdue ⚠️). 4) 'Sign off on Safety Audit' (Project C).
```

## Capabilities

### Create Projects
Sets up new project containers to group related memos and files.

### Manage Memos
Creates, reads, updates, or deletes specific notes (memos) within a defined project space.

### Access Project Details
Retrieves the full details of an entire project container.

### List and Search Memos
Gathers lists of all memos or specific notes within a project for review.

### Handle Files and Comments
Retrieves the list of files (images, PDFs) attached to a memo, or lists existing comments on that memo.

## Use Cases

### Daily Site Report Filing
A site supervisor finishes a day's work. Instead of emailing photos to 10 people, they ask their agent: 'Create a memo for the daily report.' The agent runs `create_memo`, drafts the content, and automatically tags it with the current date and project name.

### Checking Project Compliance
A PM needs to know if all required safety documents are present. They ask their agent: 'List files for Project Alpha.' The agent runs `list_memo_files` across the relevant memos and tells them instantly what's missing.

### Following Up on Issues
A team member finds an issue in a memo. They ask their AI client: 'Add a comment to the plumbing memo about the pipe leak.' The agent runs `add_memo_comment`, and everyone sees the update immediately, keeping the discussion contained.

### Retrieving Specific Data
A new team member needs info on 'HVAC installation' from six months ago. They ask their agent: 'Get me memos about HVAC.' The agent runs `list_memos` and uses the details to find the exact, correct memo using `get_memo`.

## Benefits

- Stop manually searching for documents. Use `list_memos` to get an instant index of every note in a project, cutting down hours of manual file browsing.
- Keep all associated files together. When you use `list_memo_files`, the AI agent shows you exactly which photos or PDFs are attached to that safety inspection report.
- Track conversations directly on the record. Instead of emailing follow-ups, use `add_memo_comment` to keep all discussion history linked right inside the memo itself.
- Manage project scope fast. Use `list_projects` to see every client site you've ever worked on, so you don't have to remember which folder holds what.
- Never lose data again. The combination of `create_memo` and tagging makes sure new reports are properly filed under the correct project structure instantly.

## How It Works

The bottom line is your AI agent talks directly to a database of construction and field reports, giving you immediate answers without you having to navigate multiple web portals.

1. Subscribe to the server and enter your Memo Meister API Key.
2. Tell your AI agent what you need (e.g., 'Show me all memos for the HVAC project').
3. The agent uses the tools—like `list_memos` or `get_memo`—to pull the structured data, which it then presents to you.

## Frequently Asked Questions

**How do I start organizing my documents using the Memo Meister MCP Server?**
Start by listing what you have with `list_projects`. This shows all existing project containers. You can then use `create_memo` to add a new, structured note within one of those projects.

**Can I attach PDFs and photos to memos using Memo Meister?**
Yes. Once you've created or retrieved a memo using `get_memo`, the server lets your agent run `list_memo_files` to show exactly what attachments exist, ensuring the file is correctly linked.

**What if I need to change an old report? Should I use update_memo?**
Yes. Use `update_memo` when you need to correct text or metadata in a memo without creating a whole new record. The system tracks the changes.

**Do I have to manually tag everything? Does Memo Meister help with tagging?**
While the tools focus on retrieval, the structure supports tagging and categorization by project. You can use `list_memos` to browse notes that are already sorted into specific projects.

**How do I use the `get_me` tool to verify the agent's current user identity?**
The `get_me` tool retrieves details about the authenticated user. This lets your AI client confirm permissions and scope before performing actions like creating memos or listing projects.

**What happens if I use the `delete_memo` function on an important record?**
The `delete_memo` tool permanently removes the specified memo and its associated data. Always confirm the ID first, as this action is irreversible through the MCP server.

**How do I use `list_projects` to see all available work areas?**
The `list_projects` tool provides a complete roster of every project or 'memoset' in your account. This lets your agent scope its search and ensure it's working within the correct organizational container.

**If I need to see who commented on a memo, should I use `list_memo_comments`?**
Yes, `list_memo_comments` retrieves all comments attached to a specific memo. You can track the commenter's identity and when they left their feedback directly through your agent.

**Can I read and create project memos?**
Yes. Create text memos, attach files, and organize them within specific project folders.

**What API does Memo Meister use?**
Memo Meister uses a custom API Key header against a GraphQL endpoint at `api.memomeister.com/graphql`.

**Can I search for specific field reports?**
Yes. Query the GraphQL API to search memos by tags, content, or project assignment.