Save2Obsidian

Setup guide · About 2 minutes

Save your first post.

Connect X once, pair the Obsidian plugin, and your mentions become markdown notes.

Step 01

Sign in with X

Open Save2Obsidian and choose Sign in with X. X will ask you to authorize basic read access so we can identify your account. We do not ask for permission to post, like, follow, or send direct messages.

Sign in with X
X authorization screen: Save2Obsidian wants to access your X account, with an Authorize app button
X asks you to authorize read-only access — no posting, liking, or messaging.
Step 02

Copy your personal key

After signing in, you will land on the dashboard. Find your API key, choose Show if you want to inspect it, then choose Copy key.

Keep it private. Your key lets the plugin access notes saved to your account. Do not post it or include it in screenshots.

Save2Obsidian dashboard showing the personal API key card with Show and Copy key buttons
Your dashboard shows the key to paste into the plugin — keep it private.
Step 03

Install the Obsidian plugin

Choose either method below. Installing from the Community plugins store is the simplest option.

Recommended

Community plugins store

  1. In Obsidian, open Settings → Community plugins.
  2. Turn off Restricted mode if Obsidian asks.
  3. Choose Browse and search for Save2Vault.
  4. Choose Install, then Enable.
View Save2Vault in the plugin store →
Alternative

Manual GitHub install

  1. Download the latest plugin files from GitHub Releases.
  2. Create .obsidian/plugins/save-to-vault/ inside your vault.
  3. Place main.js, manifest.json, and styles.css in that folder.
  4. Reload Obsidian, then enable Save2Vault under Community plugins.
Open plugin repository →
Obsidian Community plugins settings with the Save2Vault plugin installed and enabled
Once enabled, Save2Vault appears under Community plugins.
Step 04

Paste the key in plugin settings

Open Settings → Save2Vault, paste the key into the API key field, and click Test connection to confirm it works. Then click Sync now to run your first sync — after that, the plugin also checks for new notes automatically every 30 minutes while Obsidian is open.

Save2Vault settings in Obsidian: API key pasted, with a Connected confirmation after clicking Test connection
A successful test shows how many posts are waiting on the service.
Step 05

Mention the bot under a post

On X, open any post you want to keep. Reply with @save2obsidian. That is all you need—there is no special command syntax, and you can add your own words alongside the mention.

Replying to an X post with @save2obsidian on a phone
Reply to the post with @save2obsidian.
The @save2obsidian reply visible under the X post after sending
Your reply appears under the post — the save is on its way.
Step 06

Look in your vault

Give the service and plugin a short moment to process and sync. A new markdown note will appear in your configured Save2Obsidian folder, ready to edit, link, tag, or move.

The very first time a sync brings in notes, Save2Vault opens them for you so you can see the result right away. From then on, new posts land in the folder quietly — nothing pops up while you work.

Obsidian right after the first sync: saved notes opened automatically with a notice explaining that future posts land in the folder quietly
First sync: your new notes open automatically, once.
A saved X post as a markdown note in Obsidian, with title, author, source link, and comments
Each note keeps the author, source link, full text, and comments.

You can also check Recent saves on the dashboard to confirm that the post reached your account.

First save complete Your X post is now a markdown note.
FAQ

A few useful details

How long does a note take to appear?

Usually a short moment. Processing time can vary with the post and how often your Obsidian plugin is checking for new notes. If nothing appears after several minutes, confirm that the plugin is enabled and the key is correct, then check Recent saves on your dashboard.

Does Save2Obsidian support video?

Video posts are saved as their available text, context, and the original link. Video AI transcription is not available yet; when it ships we will announce it on the site.

Can I choose where notes are stored?

Yes. Use the Save2Vault plugin settings to choose the destination folder inside your vault.

Are images stored online or in my vault?

By default, notes keep online image links so your vault stays light. If you prefer fully offline notes, set Post images to Download images into your vault in the plugin settings — images are then saved to an attachments subfolder next to your notes.

How do I unlink my X account?

Account unlinking will move to a self-service settings page in a future update. For now, email support@save2obsidian.com and ask us to remove the link.