Temp Notes

Temp Notes MCP Server provides a lightweight temporary memory system for AI agents to store and retrieve notes across conversations. It helps maintain state and context so you can manage multi-step tasks without losing important details as conversations evolve.

How to use

You integrate the Temp Notes MCP Server into your MCP client workflow to store ephemeral information such as notes, checklists, and code snippets. Use it to write a note, read the current note, append new content, or clear the note when a task is complete. The server keeps data across conversations, so you can pick up where you left off even if your context window shifts.

Typical usage patterns include writing a note to capture a task plan, reading it later in a new conversation, and updating progress by appending new details. When a task finishes, you clear the note to start fresh for the next project.

Example usage in your client script (conceptual): you call the server with tool_name set to write_note to store content, and later call read_note to retrieve it. Then you can append more content to reflect progress or findings, and finally clear_note when the work is completed.

How to install

Prerequisites: Node.js and npm should be available on your system.

{ "mcpServers": {
  "temp-notes": {
    "command": "npx",
    "args": ["-y", "@landicefu/temp-notes-mcp-server"],
    "disabled": false
  }
}}

Option 1. Use with npx (no installation required) to add the server to your MCP configuration.

{ "mcpServers": {
  "temp-notes": {
    "command": "npx",
    "args": ["-y", "@landicefu/temp-notes-mcp-server"],
    "disabled": false
  }
}

Option 2. Install from npm (global) and reference the installed package in your MCP config.

npm install -g @landicefu/temp-notes-mcp-server

{ "mcpServers": {
  "temp-notes": {
    "command": "temp-notes-mcp-server",
    "disabled": false
  }
}

Option 3. Build from source and run locally.

git clone https://github.com/landicefu/temp-notes-mcp-server.git
cd temp-notes-mcp-server
npm install
npm run build

{ "mcpServers": {
  "temp-notes": {
    "command": "node",
    "args": ["/path/to/temp-notes-mcp-server/build/index.js"],
    "disabled": false
  }
}

Note Storage

Notes are stored locally on your system. The default storage location is a per-user file under your home directory. If the file or directory doesn’t exist when you read, you get an empty string and the system will create the file when you write next time.

If the storage file or directory is missing when reading, you receive an empty string. If the directory doesn’t exist when writing, the server creates it automatically. If the file becomes corrupted or inaccessible, you will receive an appropriate error message.

Available tools

clear_note

Clears the current note, making it empty.

write_note

Replaces the current note with a new string.

read_note

Returns the current content of the note.

append_note

Appends new text to the current note, starting with a new line. Optionally includes a separator line.