# Simplenote MCP > Simplenote MCP lets your AI client manage plain-text notes like a personal assistant. Create new ideas, search across everything you've written, edit old records, and check previous versions—all without leaving your chat window. It treats all your notes as one searchable knowledge base. ## Overview - **Category:** productivity - **Price:** Free - **Tags:** plain-text, sync-engine, note-organization, version-history, personal-knowledge-base ## Description The **Simplenote MCP** lets your AI client manage all your plain-text notes straight from your chat window. You don't gotta open the app; you just talk to your agent and it handles everything. It treats every single note, no matter how old or new, like one massive knowledge base that your agent can search through. ### Finding Specific Stuff Your agent searches across your entire library using `search_notes`, instantly pulling up any text or keyword you throw at it. If you just wanna see a quick directory of everything you've written, use `list_notes` which returns all your notes and gives you a little preview for each one. ### Capturing Ideas & Making Changes You got a new thought? You can grab it immediately using `create_note`, letting the agent generate an entirely new note with whatever text you provide. If you gotta refine something old, use `update_note` to replace the content of an existing note key; your changes save right away. ### Diving Into History and Structure You wanna check how a note looked last year? You can pull up an exact historical copy using `get_note_version`, just by giving it that unique version number. For the full scoop on any single record, `get_note_details` retrieves all the content and metadata for a specified note key. To get a complete map of your topics, run `list_tags`; this gives you a directory of every tag you've ever used across all your entries. ### Managing Your Notes The agent lets you handle the whole lifecycle of your notes. You can list them using `list_notes`, check the full details for one specific note using `get_note_details`, or even permanently wipe a record clean with `delete_note`; remember, that action is irreversible. It's basically an all-in-one way to keep track of your ideas. You don't gotta copy and paste anything into a separate app; you just talk to your agent, and it handles the whole workflow for you. ## Tools ### create_note Generates an entirely new note in Simplenote with the text you provide. ### delete_note Permanently removes a specific note from your account; this action cannot be reversed. ### get_note_details Retrieves the full content and metadata for a single, specified note key. ### get_note_version Pulls up an exact historical copy of a note based on its unique version number. ### list_notes Returns a list of all your notes, along with a quick preview of the content for each one. ### list_tags Provides a complete directory of every tag you've used across all your Simplenote entries. ### search_notes Searches the entire library for notes containing specific text or keywords. ### update_note Replaces the content of an existing note using its key, saving your changes immediately. ## Prompt Examples **Prompt:** ``` Create a new note with my meeting minutes from today. ``` **Response:** ``` Done! I created a new note titled 'Meeting Minutes — April 4, 2026' with the key `abc123def`. You can ask me to update it anytime. ``` **Prompt:** ``` Search my notes for anything about 'tax_2023'. ``` **Response:** ``` I found 1 note containing 'tax_2023'. It was last modified on March 15. Would you like me to show the full content? ``` **Prompt:** ``` Delete the note with key f1b2c3d4. ``` **Response:** ``` The note f1b2c3d4 has been permanently deleted. This action cannot be undone. ``` ## Capabilities ### Find Specific Content Your agent searches all your notes and returns any text matching a query you provide. ### Capture Ideas Instantly The agent creates a brand new note, letting you capture thoughts immediately without manual steps. ### Review Note History You check specific historical versions of any note to see exactly how it looked previously. ### Organize Knowledge Bases The agent lists all tags used in your notes, giving you a complete map of your topics. ### Manage Note Lifecycle You can list, get details for, or delete entire notes using simple commands. ## Use Cases ### Finding that one historical data point A researcher needs to cite a specific statistic from a meeting three months ago. Instead of searching through email archives, they ask their agent: "Search notes for 'Q4 budget' and give me the version before Jane added the disclaimer." The agent uses `search_notes` followed by `get_note_version`, giving them the exact text they need. ### Refining a project draft A writer has three drafts and needs to consolidate the best parts. They ask their agent to list all notes tagged 'Project Alpha' (`list_tags`), then use `get_note_details` on each one, finally compiling them into a new master document using `create_note`. ### Cleaning up old records An operations manager has dozens of notes from old training sessions. They ask the agent to list all notes and find anything marked 'Training 2021' (`list_notes`). After confirming they aren't needed, they use `delete_note` in a bulk process. ### Updating recurring info A consultant needs to update their standard client onboarding checklist. They ask the agent to retrieve the current note details (`get_note_details`), and then prompt: "Update this with the new legal disclaimer." The agent uses `update_note` immediately. ## Benefits - Find anything you wrote years ago. Instead of manually scrolling through folders, use `search_notes` to pull up specific keywords from across all notes instantly. - Never lose a draft or meeting minute again. With `get_note_version`, you can review the exact content of a note from last month without having to rely on local backups. - Keep your knowledge structured. Run `list_tags` to see every category you've used, helping you build consistency across all projects. - Draft and refine ideas rapidly. Use `create_note` or `update_note` in a single prompt to capture fleeting thoughts and save them immediately. - Keep your workflow clean. The agent lets you delete old, irrelevant notes using `delete_note`, keeping your knowledge base tight. ## How It Works The bottom line is that your AI client uses these tools to treat all your personal text notes as one unified data source. 1. Add the server to your AI client and set up your `SIMPLENOTE_APP_ID` and `SIMPLENOTE_TOKEN` credentials. 2. Ask your agent a query, like "List my notes about project X and search for anything regarding budget." 3. The agent runs `list_notes` then `search_notes`, compiles the results, and presents them to you. ## Frequently Asked Questions **How do I search my notes using the search_notes tool?** You simply ask your agent to search for text or keywords. For example: "Search all notes that mention 'Q4 strategy' and tag it with 'finance'." The agent handles the query logic. **Can I use get_note_version if I don't know the version number?** You should first run `list_notes` to confirm the note key. If you only need a slightly older draft, ask your agent; it can help narrow down the timeline for you. **Is update_note safe if I mess up?** Yes, because of `get_note_version`. Before running `update_note`, always check the historical versions first. This way, you know exactly what you're replacing. **What is the difference between list_notes and search_notes?** Running `list_notes` gives you a directory view—a quick preview of every note title and content snippet. `search_notes` digs deep, finding specific phrases buried inside any note. **When I want to use `create_note`, what credentials do I need to pass to your AI client?** You must provide valid Simplenote API credentials (App ID and Token) in the MCP configuration. Without these tokens, the agent cannot authenticate and will fail before attempting any note creation. **If I run `update_note` but supply an incorrect key, what happens?** The system immediately returns a specific error code indicating that no note exists for the key provided. This prevents data corruption and lets your agent handle the failure gracefully. **Does `list_notes` return every single note I own, or is there a limit?** It returns all available notes' keys and content previews. While it handles large volumes, remember that complex queries might require breaking down the request into chunks for optimal performance. **After running `list_tags`, how do I apply those tags to a note?** The system shows you your available tag taxonomy using `list_tags`. You then tell your agent which notes need tagging, and the agent executes the necessary update commands. **Can the integration accidentally delete important notes?** The `delete_note` tool performs a permanent deletion. We recommend instructing your AI agent to always confirm before executing any deletion. You can also use `get_note_version` to review note history before making changes. **Does it support shared or team notes?** Simplenote is designed for personal note management. This integration accesses notes tied to the authenticated user's account only. Team collaboration features are not available through the Simperium API. **Does it support Markdown formatting?** Yes. Simplenote stores plain text, so Markdown syntax is preserved as-is when you create or update notes. The Simplenote clients will render Markdown formatting natively.