[{"data":1,"prerenderedAt":494},["ShallowReactive",2],{"docs-navigation":3,"i-lucide:book-open":96,"i-lucide:history":100,"i-lucide:shield-check":102,"i-lucide:mail":104,"i-lucide:search":106,"i-lucide:moon":108,"i-lucide:sun":110,"i-lucide:menu":112,"i-lucide:chevron-down":114,"i-lucide:arrow-up-right":116,"i-simple-icons:github":118,"docs-\u002Fdocs\u002Finstall\u002Ffrom-source":120,"docs-surround-\u002Fdocs\u002Finstall\u002Ffrom-source":479,"i-lucide:arrow-left":484,"i-lucide:arrow-right":486,"i-lucide:copy":488,"i-lucide:hash":490,"i-lucide:check":492},[4],{"title":5,"path":6,"stem":7,"children":8},"Introduction","\u002Fdocs","docs\u002F1.index",[9,10,28,45,66,79],{"title":5,"path":6,"stem":7},{"title":11,"path":12,"stem":13,"children":14,"page":27},"Install","\u002Fdocs\u002Finstall","docs\u002F2.install",[15,19,23],{"title":16,"path":17,"stem":18},"Install with the installer","\u002Fdocs\u002Finstall\u002Finstaller","docs\u002F2.install\u002F1.installer",{"title":20,"path":21,"stem":22},"Install from source","\u002Fdocs\u002Finstall\u002Ffrom-source","docs\u002F2.install\u002F2.from-source",{"title":24,"path":25,"stem":26},"Register with Claude","\u002Fdocs\u002Finstall\u002Fclaude-clients","docs\u002F2.install\u002F3.claude-clients",false,{"title":29,"path":30,"stem":31,"children":32,"page":27},"Providers","\u002Fdocs\u002Fproviders","docs\u002F3.providers",[33,37,41],{"title":34,"path":35,"stem":36},"Outlook.com","\u002Fdocs\u002Fproviders\u002Foutlook","docs\u002F3.providers\u002F1.outlook",{"title":38,"path":39,"stem":40},"Gmail, Fastmail, iCloud and any IMAP server","\u002Fdocs\u002Fproviders\u002Fother-providers","docs\u002F3.providers\u002F2.other-providers",{"title":42,"path":43,"stem":44},"Overriding provider endpoints","\u002Fdocs\u002Fproviders\u002Fendpoint-overrides","docs\u002F3.providers\u002F3.endpoint-overrides",{"title":46,"path":47,"stem":48,"children":49,"page":27},"Reference","\u002Fdocs\u002Freference","docs\u002F4.reference",[50,54,58,62],{"title":51,"path":52,"stem":53},"Tools","\u002Fdocs\u002Freference\u002Ftools","docs\u002F4.reference\u002F1.tools",{"title":55,"path":56,"stem":57},"Configuration","\u002Fdocs\u002Freference\u002Fconfiguration","docs\u002F4.reference\u002F2.configuration",{"title":59,"path":60,"stem":61},"CLI","\u002Fdocs\u002Freference\u002Fcli","docs\u002F4.reference\u002F3.cli",{"title":63,"path":64,"stem":65},"Permissions","\u002Fdocs\u002Freference\u002Fpermissions","docs\u002F4.reference\u002F4.permissions",{"title":67,"path":68,"stem":69,"children":70,"page":27},"Guides","\u002Fdocs\u002Fguides","docs\u002F5.guides",[71,75],{"title":72,"path":73,"stem":74},"The settings window","\u002Fdocs\u002Fguides\u002Fsettings-window","docs\u002F5.guides\u002F1.settings-window",{"title":76,"path":77,"stem":78},"Troubleshooting","\u002Fdocs\u002Fguides\u002Ftroubleshooting","docs\u002F5.guides\u002F2.troubleshooting",{"title":80,"path":81,"stem":82,"children":83,"page":27},"About","\u002Fdocs\u002Fabout","docs\u002F6.about",[84,88,92],{"title":85,"path":86,"stem":87},"Notes and limits","\u002Fdocs\u002Fabout\u002Flimits","docs\u002F6.about\u002F1.limits",{"title":89,"path":90,"stem":91},"Architecture","\u002Fdocs\u002Fabout\u002Farchitecture","docs\u002F6.about\u002F2.architecture",{"title":93,"path":94,"stem":95},"Contributing","\u002Fdocs\u002Fabout\u002Fcontributing","docs\u002F6.about\u002F3.contributing",{"left":97,"top":97,"width":98,"height":98,"rotate":97,"vFlip":27,"hFlip":27,"body":99},0,24,"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M12 5v16m8.001-2A2 2 0 0 0 22 17V5a2 2 0 0 0-1.999-2L16 3.002A5 5 0 0 0 12 5a5 5 0 0 0-4-2H4a2 2 0 0 0-2 2v12a2 2 0 0 0 1.999 2H8a5 5 0 0 1 4 2a5 5 0 0 1 4-2z\"\u002F>",{"left":97,"top":97,"width":98,"height":98,"rotate":97,"vFlip":27,"hFlip":27,"body":101},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"M3 12a9 9 0 1 0 9-9a9.75 9.75 0 0 0-6.74 2.74L3 8\"\u002F>\u003Cpath d=\"M3 3v5h5m4-1v5l4 2\"\u002F>\u003C\u002Fg>",{"left":97,"top":97,"width":98,"height":98,"rotate":97,"vFlip":27,"hFlip":27,"body":103},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"M20 13c0 5-3.5 7.5-7.66 8.95a1 1 0 0 1-.67-.01C7.5 20.5 4 18 4 13V6a1 1 0 0 1 1-1c2 0 4.5-1.2 6.24-2.72a1.17 1.17 0 0 1 1.52 0C14.51 3.81 17 5 19 5a1 1 0 0 1 1 1z\"\u002F>\u003Cpath d=\"m9 12l2 2l4-4\"\u002F>\u003C\u002Fg>",{"left":97,"top":97,"width":98,"height":98,"rotate":97,"vFlip":27,"hFlip":27,"body":105},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"m22 7l-8.991 5.727a2 2 0 0 1-2.009 0L2 7\"\u002F>\u003Crect width=\"20\" height=\"16\" x=\"2\" y=\"4\" rx=\"2\"\u002F>\u003C\u002Fg>",{"left":97,"top":97,"width":98,"height":98,"rotate":97,"vFlip":27,"hFlip":27,"body":107},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Cpath d=\"m21 21l-4.34-4.34\"\u002F>\u003Ccircle cx=\"11\" cy=\"11\" r=\"8\"\u002F>\u003C\u002Fg>",{"left":97,"top":97,"width":98,"height":98,"rotate":97,"vFlip":27,"hFlip":27,"body":109},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M20.985 12.486a9 9 0 1 1-9.473-9.472c.405-.022.617.46.402.803a6 6 0 0 0 8.268 8.268c.344-.215.825-.004.803.401\"\u002F>",{"left":97,"top":97,"width":98,"height":98,"rotate":97,"vFlip":27,"hFlip":27,"body":111},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"4\"\u002F>\u003Cpath d=\"M12 2v2m0 16v2M4.93 4.93l1.41 1.41m11.32 11.32l1.41 1.41M2 12h2m16 0h2M6.34 17.66l-1.41 1.41M19.07 4.93l-1.41 1.41\"\u002F>\u003C\u002Fg>",{"left":97,"top":97,"width":98,"height":98,"rotate":97,"vFlip":27,"hFlip":27,"body":113},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M4 5h16M4 12h16M4 19h16\"\u002F>",{"left":97,"top":97,"width":98,"height":98,"rotate":97,"vFlip":27,"hFlip":27,"body":115},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"m6 9l6 6l6-6\"\u002F>",{"left":97,"top":97,"width":98,"height":98,"rotate":97,"vFlip":27,"hFlip":27,"body":117},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M7 7h10v10M7 17L17 7\"\u002F>",{"left":97,"top":97,"width":98,"height":98,"rotate":97,"vFlip":27,"hFlip":27,"body":119},"\u003Cpath fill=\"currentColor\" d=\"M12 .297c-6.63 0-12 5.373-12 12c0 5.303 3.438 9.8 8.205 11.385c.6.113.82-.258.82-.577c0-.285-.01-1.04-.015-2.04c-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729c1.205.084 1.838 1.236 1.838 1.236c1.07 1.835 2.809 1.305 3.495.998c.108-.776.417-1.305.76-1.605c-2.665-.3-5.466-1.332-5.466-5.93c0-1.31.465-2.38 1.235-3.22c-.135-.303-.54-1.523.105-3.176c0 0 1.005-.322 3.3 1.23c.96-.267 1.98-.399 3-.405c1.02.006 2.04.138 3 .405c2.28-1.552 3.285-1.23 3.285-1.23c.645 1.653.24 2.873.12 3.176c.765.84 1.23 1.91 1.23 3.22c0 4.61-2.805 5.625-5.475 5.92c.42.36.81 1.096.81 2.22c0 1.606-.015 2.896-.015 3.286c0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12\"\u002F>",{"id":121,"title":20,"body":122,"description":471,"extension":472,"icon":473,"meta":474,"navTitle":475,"navigation":476,"path":21,"seo":477,"stem":22,"__hash__":478},"docs\u002Fdocs\u002F2.install\u002F2.from-source.md",{"type":123,"value":124,"toc":466},"minimark",[125,129,138,146,151,227,238,242,249,306,325,349,371,413,433,437,462],[126,127,20],"h1",{"id":128},"install-from-source",[130,131,132,133,137],"p",{},"Everything the ",[134,135,136],"a",{"href":17},"installer"," automates, done by hand.\nThis is also the only route on macOS, which has no published installer.",[130,139,140,141,145],{},"Requires ",[142,143,144],"strong",{},"Python 3.11 or newer",".",[147,148,150],"h2",{"id":149},"linux-and-macos","Linux and macOS",[152,153,158],"pre",{"className":154,"code":155,"language":156,"meta":157,"style":157},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","cd \u002Fpath\u002Fto\u002Frubit-mcp-mail\nconda create -p .\u002F.venv python=3.12 pip -y     # this machine has no python3-venv\n.\u002F.venv\u002Fbin\u002Fpython -m pip install -e .\n","bash","",[159,160,161,174,207],"code",{"__ignoreMap":157},[162,163,166,170],"span",{"class":164,"line":165},"line",1,[162,167,169],{"class":168},"s2Zo4","cd",[162,171,173],{"class":172},"sfazB"," \u002Fpath\u002Fto\u002Frubit-mcp-mail\n",[162,175,177,181,184,187,190,193,197,200,203],{"class":164,"line":176},2,[162,178,180],{"class":179},"sBMFI","conda",[162,182,183],{"class":172}," create",[162,185,186],{"class":172}," -p",[162,188,189],{"class":172}," .\u002F.venv",[162,191,192],{"class":172}," python=",[162,194,196],{"class":195},"sbssI","3.12",[162,198,199],{"class":172}," pip",[162,201,202],{"class":172}," -y",[162,204,206],{"class":205},"sHwdD","     # this machine has no python3-venv\n",[162,208,210,213,216,218,221,224],{"class":164,"line":209},3,[162,211,212],{"class":179},".\u002F.venv\u002Fbin\u002Fpython",[162,214,215],{"class":172}," -m",[162,217,199],{"class":172},[162,219,220],{"class":172}," install",[162,222,223],{"class":172}," -e",[162,225,226],{"class":172}," .\n",[130,228,229,230,233,234,237],{},"A plain ",[159,231,232],{},"python3 -m venv .venv"," works just as well wherever ",[159,235,236],{},"python3-venv"," is\navailable.",[147,239,241],{"id":240},"windows","Windows",[130,243,244,245,248],{},"Use a standard venv (no conda needed — ",[159,246,247],{},"venv"," ships with the Python installer\non Windows) from PowerShell:",[152,250,254],{"className":251,"code":252,"language":253,"meta":157,"style":157},"language-powershell shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","cd C:\\path\\to\\rubit-mcp-mail\npy -3.12 -m venv .venv\n.venv\\Scripts\\python.exe -m pip install -e .\n","powershell",[159,255,256,274,288],{"__ignoreMap":157},[162,257,258,262,266,269,271],{"class":164,"line":165},[162,259,261],{"class":260},"sTEyZ","cd C:\\path\\to\\rubit",[162,263,265],{"class":264},"sMK4o","-",[162,267,268],{"class":260},"mcp",[162,270,265],{"class":264},[162,272,273],{"class":260},"mail\n",[162,275,276,279,282,285],{"class":164,"line":176},[162,277,278],{"class":260},"py ",[162,280,281],{"class":195},"-3.12",[162,283,284],{"class":264}," -",[162,286,287],{"class":260},"m venv .venv\n",[162,289,290,293,296,298,301,303],{"class":164,"line":209},[162,291,292],{"class":260},".venv\\Scripts\\",[162,294,295],{"class":168},"python.exe",[162,297,284],{"class":264},[162,299,300],{"class":260},"m pip install ",[162,302,265],{"class":264},[162,304,305],{"class":260},"e .\n",[130,307,308,309,312,313,316,317,320,321,324],{},"Everywhere the rest of these docs show ",[159,310,311],{},".\u002F.venv\u002Fbin\u002Frubit-mcp-mail",", use\n",[159,314,315],{},".venv\\Scripts\\rubit-mcp-mail.exe"," instead (or ",[159,318,319],{},".venv\\Scripts\\python.exe -m rubit_mcp_mail"," if you'd rather not depend on the ",[159,322,323],{},".exe"," shim). For example:",[152,326,328],{"className":251,"code":327,"language":253,"meta":157,"style":157},".venv\\Scripts\\rubit-mcp-mail.exe auth outlook\n.venv\\Scripts\\rubit-mcp-mail.exe doctor\n",[159,329,330,340],{"__ignoreMap":157},[162,331,332,334,337],{"class":164,"line":165},[162,333,292],{"class":260},[162,335,336],{"class":168},"rubit-mcp-mail.exe",[162,338,339],{"class":260}," auth outlook\n",[162,341,342,344,346],{"class":164,"line":176},[162,343,292],{"class":260},[162,345,336],{"class":168},[162,347,348],{"class":260}," doctor\n",[130,350,351,352,355,356,359,360,363,364,367,368,370],{},"The config file lives at ",[159,353,354],{},"%USERPROFILE%\\.config\\rubit-mcp-mail\\config.toml","\n— ",[159,357,358],{},"Path.home() \u002F \".config\""," resolves there on Windows too. The simplest way to\ncreate it is ",[159,361,362],{},".venv\\Scripts\\rubit-mcp-mail.exe gui"," and adding an account there,\nwhich writes the file for you; to do it by hand, use ",[159,365,366],{},"mkdir"," and a text editor\ninstead of the heredoc the\n",[134,369,55],{"href":56}," page shows:",[152,372,374],{"className":251,"code":373,"language":253,"meta":157,"style":157},"mkdir $env:USERPROFILE\\.config\\rubit-mcp-mail\nnotepad $env:USERPROFILE\\.config\\rubit-mcp-mail\\config.toml\n",[159,375,376,395],{"__ignoreMap":157},[162,377,378,381,384,387,389,391,393],{"class":164,"line":165},[162,379,380],{"class":260},"mkdir ",[162,382,383],{"class":264},"$",[162,385,386],{"class":260},"env:USERPROFILE\\.config\\rubit",[162,388,265],{"class":264},[162,390,268],{"class":260},[162,392,265],{"class":264},[162,394,273],{"class":260},[162,396,397,400,402,404,406,408,410],{"class":164,"line":176},[162,398,399],{"class":260},"notepad ",[162,401,383],{"class":264},[162,403,386],{"class":260},[162,405,265],{"class":264},[162,407,268],{"class":260},[162,409,265],{"class":264},[162,411,412],{"class":260},"mail\\config.toml\n",[414,415,418],"callout",{"color":416,"icon":417},"success","i-lucide-check",[130,419,420,423,424,427,428,432],{},[142,421,422],{},"Token storage is simpler on Windows than on Linux."," ",[159,425,426],{},"keyring"," talks to the\nbuilt-in Windows Credential Manager with no extra setup, so the DBUS\u002Fkeyring\nworkaround described in\n",[134,429,431],{"href":430},"\u002Fdocs\u002Finstall\u002Fclaude-clients#claude-desktop","Register with Claude clients","\ndoes not apply — every environment (terminal, Claude Desktop, a scheduled task)\ncan already reach the same credential store.",[147,434,436],{"id":435},"next","Next",[438,439,440,446,452,458],"ol",{},[441,442,443],"li",{},[134,444,445],{"href":56},"Configure an account",[441,447,448,449],{},"Sign in: ",[159,450,451],{},".\u002F.venv\u002Fbin\u002Frubit-mcp-mail auth \u003Caccount>",[441,453,454,455],{},"Verify: ",[159,456,457],{},".\u002F.venv\u002Fbin\u002Frubit-mcp-mail doctor",[441,459,460],{},[134,461,24],{"href":25},[463,464,465],"style",{},"html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}",{"title":157,"searchDepth":176,"depth":209,"links":467},[468,469,470],{"id":149,"depth":176,"text":150},{"id":240,"depth":176,"text":241},{"id":435,"depth":176,"text":436},"Run rubit-mcp-mail from a checkout on Linux, macOS or Windows.","md","i-lucide-git-branch",{},"From source",true,{"title":20,"description":471},"-qgt7OGerGc-BN548AkT5H7xTKIi3pOBJO94G1Ikj3o",[480,482],{"title":16,"path":17,"stem":18,"description":481,"children":-1},"Download one file, run it, and your mailbox is wired into Claude.",{"title":24,"path":25,"stem":26,"description":483,"children":-1},"Point Claude Code and Claude Desktop at the server, including the Linux keyring workaround.",{"left":97,"top":97,"width":98,"height":98,"rotate":97,"vFlip":27,"hFlip":27,"body":485},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"m12 19l-7-7l7-7m7 7H5\"\u002F>",{"left":97,"top":97,"width":98,"height":98,"rotate":97,"vFlip":27,"hFlip":27,"body":487},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M5 12h14m-7-7l7 7l-7 7\"\u002F>",{"left":97,"top":97,"width":98,"height":98,"rotate":97,"vFlip":27,"hFlip":27,"body":489},"\u003Cg fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\">\u003Crect width=\"14\" height=\"14\" x=\"8\" y=\"8\" rx=\"2\" ry=\"2\"\u002F>\u003Cpath d=\"M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2\"\u002F>\u003C\u002Fg>",{"left":97,"top":97,"width":98,"height":98,"rotate":97,"vFlip":27,"hFlip":27,"body":491},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M4 9h16M4 15h16M10 3L8 21m8-18l-2 18\"\u002F>",{"left":97,"top":97,"width":98,"height":98,"rotate":97,"vFlip":27,"hFlip":27,"body":493},"\u003Cpath fill=\"none\" stroke=\"currentColor\" stroke-linecap=\"round\" stroke-linejoin=\"round\" stroke-width=\"2\" d=\"M20 6L9 17l-5-5\"\u002F>",1789573343517]