xcortex-mcp
XCortex MCP server: documentation and setup (remote server at https://xcortex.com/mcp/connect)
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/xcortex-app--xcortex-mcp)HTML
<a href="/listings/xcortex-app--xcortex-mcp"><img src="/api/listings/xcortex-app--xcortex-mcp/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Add the remote server at `https://xcortex.com/mcp/connect`. When your client prompts you, sign in to XCortex and choose **Allow**. You do not put an API key or client secret in the config; clients discover OAuth from the server.
More detail, including Claude, ChatGPT, Gemini, and Grok, is on the [setup page](https://xcortex.com/connect).
VS Code and GitHub Copilot
1. In VS Code, with Copilot selected, run **Chat: Open Customizations**, open **MCP Servers**, and choose **Add Server**. 2. Choose **HTTP** and enter `https://xcortex.com/mcp/connect`. 3. Give the server a name such as `xcortex`, then complete the OAuth sign-in when prompted.
You can also add a workspace config in `.vscode/mcp.json`:
{
"servers": {
"xcortex": {
"type": "http",
"url": "https://xcortex.com/mcp/connect"
}
}
}Claude
XCortex is in [Claude's connector directory](https://claude.ai/directory/connectors/xcortex). Open that listing and choose **Connect**, or in Claude go to **Settings → Connectors → Add custom connector** and use `https://xcortex.com/mcp/connect`. Claude will open XCortex: sign in if asked, confirm the request is for Claude, and choose **Allow**.
For Claude Code:
claude mcp add --transport http xcortex https://xcortex.com/mcp/connect
Then run `/mcp` and authenticate.
Cursor
Add the server in **Cursor Settings → MCP**, or put this in `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (one project):
{
"mcpServers": {
"xcortex": {
"url": "https://xcortex.com/mcp/connect"
}
}
}Cursor will prompt you to sign in with OAuth. Do not put a client secret in this file.
You can also use Cursor's install link:
[Add XCortex to Cursor](https://cursor.com/install-mcp?name=xcortex&config=eyJ1cmwiOiJodHRwczovL3hjb3J0ZXguY29tL21jcC9jb25uZWN0In0=)
Other MCP clients
Point the client at the Streamable HTTP endpoint `https://xcortex.com/mcp/connect` and complete the OAuth sign-in when prompted. Config field names vary by client; a typical remote entry looks like this:
{
"mcpServers": {
"xcortex": {
"url": "https://xcortex.com/mcp/connect"
}
}
}What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 124 lines
- # XCortex
- XCortex is an AI planner. From any MCP client, you can add, find, move, and complete tasks, plan your days, and track goals.
- This public repository documents the official MCP Registry entry [`com.xcortex/xcortex`](https://registry.modelcontextprotocol.io/v0/servers?search=com.xcortex/xcortex). The server itself is hosted remotely; this repo does not contain server code.
- - **Remote URL:** `https://xcortex.com/mcp/connect` (Streamable HTTP)
- - **Setup guide:** [xcortex.com/connect](https://xcortex.com/connect)
- - **Auth:** Sign in with your XCortex account when your client starts the OAuth flow. You need an XCortex account.
- ## What you can do
- Once connected, ask your assistant in plain language, for example:
- - “Add pick up the dry cleaning tomorrow at 5pm to XCortex.”
- - “What's on my XCortex list today?”
- - “What's left on my Move to Denver project?”
- - “Change 'Buy milk' to 10am and append a note that it's 2%.”
- - “Mark call the plumber as done.”
- - “Move my dentist appointment to Friday and remind me the day before.”
- - “Plan my week: chem test Thursday, soccer Tuesday and Thursday.”
- - “How are my goals doing?”
- - “Undo that.”
- - “Send feedback to XCortex: …”
- You approve the connection on XCortex's own page. Changes made through a connector can be undone. Larger or destructive changes are confirmed before they are applied. You can disconnect at any time in XCortex under **Settings → Connections → Other assistants**.
- ## Tools
- The remote server provides these tools:
- | Tool | What it does |
- | --- | --- |
- | `agenda` | Your day in one read: your time zone and local time, open tasks for the day (time, project, reminders), overdue tasks, items coming due, and each active goal's status. Read-only. |
- | `list` | List tasks by day or range, matching words, the steps of a project, overdue or undated (backlog) items, tasks that keep getting postponed, or what was completed in a period. Returns id, title, date, time, status, project, repeats, whether it has notes or steps, and how often it has been postponed. Read-only. |
- | `get` | Read one task in full: title, date, time, status, project, steps, and notes. Read-only. |
- | `goals` | Your goals and their current status, days left when there is a deadline, share of this week's completed work, and weeks without activity. Read-only. |
- | `add` | Add a task, or several at once, with an optional date, time, project, notes, and reminder. With no date, the task goes in the backlog. A closely matching open task on the same day is not added twice unless you ask to duplicate it. Repeats and multi-step plans go through `ask_xcortex`. |
- | `edit` | Change an existing task by id: title, date (including backlog), time (or clear it), notes (replace or append), reminder, and status (`open`, `done`, or `cancelled`). Cancelling keeps the task, marked cancelled, and is reversible. Only the fields you pass change. Deleting a task goes through `ask_xcortex`, which asks first. |
- | `move` | Move one or more tasks to a day, or to the backlog. A repeating task's occurrence moves on its own; the series is unchanged. Moving more than 10 at once asks for confirmation first. |
- | `complete` | Mark a task done, by id or by its text. An optional note is appended to the task's notes, never replaced. If the text matches several open tasks, nothing is changed and the matches are returned so you can pick one. |
- | `ask_xcortex` | Anything else, in your own words: reschedule, plan a project or a week, break a task into steps, cancel or delete, set a reminder or a repeat, count or look back over history, or send feedback to the XCortex team. XCortex's own assistant handles it with your full context. Big or destructive changes are described first and applied only after confirmation. |
- | `undo` | Undo the most recent change an assistant made in XCortex. One call undoes one step. It does not undo a change you made yourself in the XCortex app. |
- ## Setup
- Add the remote server at `https://xcortex.com/mcp/connect`. When your client prompts you, sign in to XCortex and choose **Allow**. You do not put an API key or client secret in the config; clients discover OAuth from the server.
- More detail, including Claude, ChatGPT, Gemini, and Grok, is on the [setup page](https://xcortex.com/connect).
- ### VS Code and GitHub Copilot
- 1. In VS Code, with Copilot selected, run **Chat: Open Customizations**, open **MCP Servers**, and choose **Add Server**.
- 2. Choose **HTTP** and enter `https://xcortex.com/mcp/connect`.
- 3. Give the server a name such as `xcortex`, then complete the OAuth sign-in when prompted.
- You can also add a workspace config in `.vscode/mcp.json`:
- ```json
- {
- "servers": {
- "xcortex": {
- "type": "http",
- "url": "https://xcortex.com/mcp/connect"
- }
- }
- }
- ```
- ### Claude
- XCortex is in [Claude's connector directory](https://claude.ai/directory/connectors/xcortex). Open that listing and choose **Connect**, or in Claude go to **Settings → Connectors → Add custom connector** and use `https://xcortex.com/mcp/connect`. Claude will open XCortex: sign in if asked, confirm the request is for Claude, and choose **Allow**.
- For Claude Code:
- ```bash
- claude mcp add --transport http xcortex https://xcortex.com/mcp/connect
- ```
- Then run `/mcp` and authenticate.
- ### Cursor
- Add the server in **Cursor Settings → MCP**, or put this in `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (one project):
- ```json
- {
- "mcpServers": {
- "xcortex": {
- "url": "https://xcortex.com/mcp/connect"
- }
- }
- }
- ```
- Cursor will prompt you to sign in with OAuth. Do not put a client secret in this file.
- You can also use Cursor's install link:
- [Add XCortex to Cursor](https://cursor.com/install-mcp?name=xcortex&config=eyJ1cmwiOiJodHRwczovL3hjb3J0ZXguY29tL21jcC9jb25uZWN0In0=)
- ### Other MCP clients
- Point the client at the Streamable HTTP endpoint `https://xcortex.com/mcp/connect` and complete the OAuth sign-in when prompted. Config field names vary by client; a typical remote entry looks like this:
- ```json
- {
- "mcpServers": {
- "xcortex": {
- "url": "https://xcortex.com/mcp/connect"
- }
- }
- }
- ```
- ## Privacy, terms, and support
- - [Privacy Policy](https://xcortex.com/privacy)
- - [Terms of Service](https://xcortex.com/terms)
- - Support: [support@xcortex.com](mailto:support@xcortex.com)
- You can also tell your assistant to “send feedback to XCortex: …” and your words are passed to the team.
- The assistant you connect receives the tasks, notes, and results its requests return, and handles them under your agreement with that provider. XCortex does not receive your conversations with the assistant, only the requests its tools send. Details are in the [Privacy Policy, section 5](https://xcortex.com/privacy).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.